boxy

draws a box with width w , height h , color color at position xpos

boxy2

draws a box with width w , height h , color color at position xpos

similar to boxy but with random color for each element rather than each box

centerMark

draws a red dot in the middle of the screen xpos only and also can show pos

centerpos

tries to move so that string is centered when printing

var s = "Hello I am centered"
centerPos(s)
printLn(s,gray)

centerX

returns an int with best terminal center position

checkMem

reads meminfo to give memory status for memtotal,memfree and memavailable maybe usefull during debugging of a function to see how memory is consumed

checkMemFull

full 45 lines output of system memory status

checkPrime

within maxinteger range

checks an int for primeness and returns true or false

cleanScreen

very fast clear screen proc with escape seqs

similar to terminal.eraseScreen() but cleans the terminal window

more completely

createRandomDataFile

this will create a file with given filename and size 1 MB filled with strong random data

createRandomDataFile("niip2.wsx")
var bc = 0
var b = @[100,200,300,700,800,3000]
withFile(fs,"niip2.wsx",fmRead):
  var line =""
  while fs.readLine(line):
     inc bc
     if bc in b:
       printLn($bc & rightarrow & spaces(3) & wrapwords(line.replace(" ",""),(tw - 5)),yellowgreen)
echo bc

createSeqApl

returns a seq containing apl language symbols

createSeqBinary

returns a seq of integers between 0 and 1

chars to draw a box

returns a seq containing unicode box drawing chars

import nimcx
var b = createSeqCJK()
var col = 0
for x in 0 ..< b.len:
   printbicol(fmtx(["<6","",""],$x," : ", b[x]))
   inc col
   if col > 10:
      col = 0
      echo()
echo()

createSeqFloat

convenience proc to create an unsorted seq of rand floats with

default length ma = 10 ( always consider how much memory is in the system )

prec enables after comma precision up to 16 positions after comma

this is on a best attempt basis and may not work all the time

default after comma positions is prec = 3 max

form @0.34,0.056,... or similar

# create a seq with 50 rand floats
echo createSeqFloat(50)

# create a seq with 50 rand floats formatted
echo createSeqFloat(50,3)

createSeqGeoshapes

returns a seq containing geoshapes unicode chars

hiragana

returns a seq containing hiragana unicode chars

createSeqIching

returns a seq containing iching unicode chars

createSeqInt

convenience proc to create a seq of rand int with

default length 10

gives @4556,455,888,234,... or similar

# create a seq with 50 rand integers ,of set 100 .. 2000
# including the limits 100 and 2000
echo createSeqInt(50,100,2000)

full width katakana

returns a seq containing full width katakana unicode chars

curFw

mirrors terminal Forward

curMove

conveniently move the to where you need it

relative of current postion , which you app need to track itself

setting off terminal will wrap output to next line

cxCpuInfo

executes a system command to get cpu information

cxInput

simple input function with desired color and position if allowBlank is false then an alert message will be shown and function will wait for input again

allowBlank if set to true will allow "" as result

result is a string for further processing as needed.

cleanScreen()
curset(1,5)
var name = cxInput("Enter your name : ",yellowgreen,xpos=1)
curset(30,5)
var age = cxInput("Enter your age : ",yellowgreen,xpos=30)
curset(60,5)
var wallet = cxInput("Enter your Bitcoin wallet No : ",yellowgreen,xpos=60)
decho(2)
cxprintLn 1,satBlue,styleReverse,"Results "
cxprintln 1,yellowgreen,"Replies given : " ,termwhite, name,"  ",age," ",wallet

cxIsDigit

checks if a string consists of elements in a digitset that is numbers 0..9 and separators like '.' or ',' default sep = '.'

cxlpad

pads a string on the left side with spaces to specified padlen

cxlpadN

left pad for numbers

pads a number on the left side with "0" default or string to specified padlen

cxlpadN

left pad for numbers

pads a string on the left side with "0" default or string to specified padlen

cxlpdx

same as cxpad but with padding char count in front

cxpad

pads a string on the right side with spaces to specified padlen

pdx

same as cxpad but with padding char count in front

cxtoLower

will be deprecated soon

use toLowerAscii()

cxVideoInfo

executes a system command to get video setup information may show warning on certain systems to run as super user

lshw needs to be installed on your system see lshw man pages for much more

cxYesNo

returns a bool , any reply other than y , yes is false

distanceTo

calculates distance on the great circle using haversine formular

input is 2 tuples of (longitude,latitude)

Example

also see https://github.com/qqtop/Nim-Snippets/blob/master/geodistance.nim

import nimcx
echo "Hongkong - London"
echo distanceto((114.109497,22.396427),(-0.126236,51.500153)) , " km"
echo distanceto((114.109497,22.396427),(-0.126236,51.500153)) / 1.609345 ," miles"
decho()

doFlag

prints a little flag

import nimcx

# print word Hello : in color dodgerblue followed by 6 little flags in red
# and the word alert in color truetomato followed by 6 little flags in red

print("Hello :  " & doflag(red,6,"alert",truetomato) & spaces(1) & doflag(red,6), dodgerblue)

fastsplit

code by jehan lifted from Nim Forum

maybe best results compile prog with : nim cc -d:release --gc:markandsweep

seperator must be a char type

fastWrite

good for logging or vast file writes

based on code ex https://hookrace.net/blog/writing-an-async-logger-in-nim/

var fft:File
discard open(fft,"fast.txt",fmReadWrite)
fastWrite(fft,"test " * 100)
fft.close()

ff2Eu

convert a number into EU locale formatted string 1234567.123 --> 1.234.567,123 set after comma positions with n , default is 3

echo ff2Eu(1234567.123)

fmtx

:: simple format utility similar to strfmt to accommodate our needs implemented : right or left align within given param and float precision returns a string and seems to work fine with strformat

Some observations:

If text starts with a digit it must be on the right side... Function calls must be executed on the right side

Space adjustment can be done with any "" on left or right side an assert error is thrown if format block left and data block right are imbalanced the "" acts as suitable placeholder

If one of the operator chars are needed as a first char in some text put it on the right side

Operator chars : < > .

<12 means align left and pad so that max length = 12 and any following char will be in position 13

12 means align right so that the most right char is in position 12 8.2 means align a float right so that most right char is position 8 with precision 2

Note that thousand separators are counted as position so 123456 needs echo fmtx("<10.2",123456) ---> 123,456.00

Examples :

import nimcx
echo fmtx(["","","<8.3",""," High : ","<8","","","","","","","",""],lime,"Open : ",unquote("1234.5986"),yellow,"",3456.67,red,downarrow,white," Change:",unquote("-1.34 - 0.45%"),"  Range : ",lime,@[123,456,789])
echo fmtx(["","<18",":",">15","","",">8.2"],salmon,"nice something",steelblue,123,spaces(5),yellow,456.12345676)
echo()
showRuler()
for x in 0.. 10: printlnBiCol(fmtx([">22",">10"],"nice something :",x ))
echo()
printLnBiCol(fmtx(["",">15.3f"],"Result : ",123.456789),lime,red,":",0,false,{})  # formats the float to a string with precision 3 the f is not necessary
echo()
echo fmtx([">22.3"],234.43324234)  # this formats float and aligns last char to pos 22
echo fmtx(["22.3"],234.43324234)   # this formats float but ignores position as no align operator given
printLnBiCol(fmtx([">15." & $getRndInt(2,4),":",">10"],getRndFloat() * float(getRndInt(50000,500000)),spaces(5),getRndInt(12222,10000000)))

fromCString

convert C pointer to Nim string (code ex nim forum https://forum.nim-lang.org/t/3045 by jangko)

loopy(1..10,echo genMacAddress())

getAsciicode

returns a seqint with ascii integer codes of every character in a string

getEmojisSmall

a seq with 246 emojis will be returned

for easy use in your text strings

getPassword

convenience function, prompts user for a password to be checked against a passwordhash which could come from a security database or other source

getPointInSphere

returns x,y,z coordinates for a point in sphere with max size 1,1,1

https://karthikkaranth.me/blog/generating-random-points-in-a-sphere/#better-choice-of-spherical-coordinates

# display 100 coordinates of in sphere points
for x in countup(0,99,1):
   let b = getPointinSphere()
   cxwriteln(fmtx(["","","",">7","","","",">7","","","",">7"],limegreen, "  x: ",white, b[0],limegreen,"  y: ",white,b[1],limegreen,"  z: ",white,b[2]))

getPrimeSeq

returns all primes from x to y in a seqint

showSeq(getPrimeSeq(5000,10000))

getRandomFloat

convenience proc so we do not need to import rand in calling prog

to get positive or negative rand floats multiply with getRandomSignF

getRandomPoint

generate a random x,y float point pair and return it as RpointFloat

minx min x value maxx max x value miny min y value maxy max y value

for x in 1..10:
    let n = getRandomPoint(-500.00,200.0,-100.0,300.00)
    cxwriteln(fmtx(["",">3","",">4","",">7.2","","",">4","",">7.2"],
    "point ",$x,
    yellowgreen," x:",termwhite,ff2(n.x,4),
    spaces(3),
    yellowgreen," y:",termwhite,ff2(n.y,4)))
decho(2)

getRandomPoint

generate a random x,y int point pair and return it as RpointInt

min x or y value max x or y value

for x in 0..10:
    var n = getRandomPoint(-500,500,-500,200)
    cxwriteln(fmtx([">4",">5","",">6",">5"],"x:",$n.x,spaces(7),"y:",$n.y),spaces(7))

getRandomPointInCircle

based on answers found in

http://stackoverflow.com/questions/5837572/generate-a-random-point-within-a-circle-uniformly

import nimcx
# get randompoints in a circle
var crad:float = 2.1
for x in 0..100:
    var k = getRandomPointInCircle(crad)
    assert k[0] <= crad and k[1] <= crad
    if k[0] <= crad and k[1] <= crad:
        printLnBiCol(fmtx([">25","<6",">10"],ff2(k[0])," :",ff2(k[1])))
    else:
        printLnBiCol(fmtx([">25","<6",">10"],ff2(k[0])," :",ff2(k[1])),colLeft=red,colRight=red)

getRandomSignF

returns -1.0 or 1.0 float to have a rand positive or negative multiplier

getRandomSignI

returns -1 or 1 integer to have a rand positive or negative multiplier

getRndFloat

same as getrandFloat()

isBlank

returns true if a string is blank

isEmpty

returns true if a string is empty if spaces are removed

memCheck

memCheck shows memory before and after a GC_FullCollect run

set stats to true for full GC_getStatistics @1, 2, 4, 8, 16, 32

newHiragana

creates a random hiragana word without meaning from the hiragana unicode set

default min word length minwl = 3

default max word length maxwl = 10

newKatakana

creates a random katakana word without meaning from the katakana unicode set

default min word length minwl = 3

default max word length maxwl = 10

newText

creates random text made up of random chars from

var. newWord procs

textgen can be one of :

newWord newWord2 newWord3 newHiragana newKatakana newWordCJK

printLn(newText(10000,"newHiragana"),rndcol)

newWord

creates a new lower case random word with chars from Letters set

default min word length minwl = 3

default max word length maxwl = 10

newWord2

creates a new lower case random word with chars from IdentChars set

default min word length minwl = 3

default max word length maxwl = 10

newWord3

creates a new lower case random word with chars from AllChars set if nflag = true

creates a new anycase word with chars from AllChars set if nflag = false

default min word length minwl = 3

default max word length maxwl = 10

newWordCJK

creates a new random string consisting of n chars default = max 10

with chars from the cjk unicode set

http://unicode-table.com/en/#cjk-unified-ideographs

requires unicode

# create a string of chinese or CJK chars with length 20
echo newWordCJK(20,20)

product

returns product of float or int seqs

if a seq contains a 0 element than result will be 0

pswwaux

utility bash command : ps -ww aux | sort -nk3 | tail displays output in console

quickBinaryString

returns a random binary string with desired width

quickClean

very fast clear screen proc with escape seqs

cursor is temporarily disabled

quickLargeInt

returns a random large int string

quickPw

quick strong password generator

quick strong password generator

randpos

sets to a random position in the visible terminal window

returns x position

while 1 == 1:
   for z in 1.. 50:
      print($z,randcol(),xpos = randpos())
   sleepy(0.0015)

reverse

in place reverse sequence

reverseMe

reverse a sequence

var z = @["nice","bad","abc","zztop","reverser"]
printLn(z,lime)
printLn(z.reverseMe,red)

reverseString

reverses chars in a word

var s = "A text to reverse could be this example 12345.0"
echo "Original      : " & s
echo "reverseText   : " & reverseText(s)
echo "reverseString : " & reverseString(s)
# check if back to original is correct
assert s == reverseString(reverseString(s))

reverseText

reverses words in a sentence

rndRGB

returns a random RGB value from colors available in colorNames see cxconsts.nim for available values

rndStr

random string with len n between 0 and hex 4DB5

sampleSeq

returns a continuous subseq a..b from an array or seq if a >= b

import nimcx
let x = createSeqInt(20)
echo x
echo x.sampleseq(4,8)
echo x.sampleSeq(4,8).rndSample()    # get one randly selected value from the subsequence

seqHighLite

displays the passed in seq with highlighting of subsequence

import nimcx
var b = createSeqInt(30,1,10)
seqHighLite(b,@[5])   # subseq will be highlighted if found

seqLeft

returns a new seq with n left end elements of the original seq

seqRight

returns a new seq with n right end elements of the original seq

shift takes a seq and returns the first item, and deletes it from the seq

build in pop does the same from the other side

var a: seq[float] = @[1.5, 23.3, 3.4]
echo shift(a)
echo a

showEmojisSmall

show a table of small emojis

Example

showEmojisSmall()
let es = getemojisSmall()
loopy(0..10,printLn((es[197] & es[244] & es[231] ) * 20,rndcol))

showHostNameCtl

output of system hostnamectl command

showRandomCard

shows a random card at xpos from the cards set in cxconstant.nim, default is centered

ruler

simple terminal ruler indicating dot x positions starts with position 1

horizontal --> vert = false

for vertical --> vert = true

# this will show a full terminal width ruler
showRuler(fgr=pastelblue)
decho(3)
# this will show a specified position only
showRuler(xpos =22,xposE = 55,fgr=pastelgreen)
decho(3)
# this will show a full terminal width ruler starting at a certain position
showRuler(xpos = 75,fgr=pastelblue)

showRune :: utility proc to show a single unicode char given in hex representation note that not all unicode chars may be available on all systems

Example

showSeq

simple table routine with default 6 cols for displaying various unicode sets fgr allows color display and fgr = "rand" displays in rand color and maxwidth for displayable items this can also be used to show items of a sequence displayflag == true means to show the output displayflag == false means do not show output , but return it as a string indexstart == 0 displays item index from 0 or from whatever indexstart is set to .. code-block:: nim showSeq(createSeqCJK(),"rand",indexstart=1) showSeq(createSeqKatakana(),yellowgreen) showSeq(createSeqCJK(),"rand") showSeq(createSeqGeoshapes(),randcol()) showSeq(createSeqint(1000,10000,100000))

Example:

discard showSeq(createSeqCJK(),"rand")

splitty

same as build in split function but this retains the

separator on the left side of the split

z = splitty("Nice weather in : Djibouti",":")

will yield:

Nice weather in : Djibouti

rather than:

Nice weather in Djibouti

with the original split()

streamFile

creates a new filestream opened with the desired filemode

sum

returns sum of float or int seqs

same effect as math.sum

superheader

a framed header display routine

suitable for one line headers , overlong lines will

be cut to terminal window width without ceremony

superheader

a framed header display routine

suitable for one line headers , overlong lines will

be cut to terminal window size without ceremony

import nimcx

superheader("Ok That's it for Now !",skyblue,lightslategray)
echo()

tupleToStr

tuple to string unpacker , returns a string

code ex nim forum

echo tupleToStr((1,2))         # prints (1, 2)
echo tupleToStr((3,4))         # prints (3, 4)
echo tupleToStr(("A","B","C")) # prints (A, B, C)

tupletypes

returns the field types of a tuple in a seqstring

uniform

returns a rand float uniformly distributed between a and b

# run in terminal with min. 30 rows
import nimcx,stats
proc quickTest() =
     var ps : Runningstat
     var  n = 100_000_000
     printLnBiCol("Each test loops : " & $n & " times\n\n")
     
     for x in 0..<n: ps.push(uniform(0.00,100.00))
     printLn("uniform",salmon)
     showStats(ps)
     ps.clear
     for x in 0..<n: ps.push(getRandomFloat() * 100)
     curup(15)
     printLn("getRandomFloat * 100",salmon,xpos = 30)
     showStats(ps,xpos = 30)
     
     ps.clear
     for x in 0..<n: ps.push(getRndInt(0,100))
     curup(15)
     printLn("getRndInt",salmon,xpos = 60)
     showStats(ps,xpos = 60)

quickTest()
doFinish()

unquote

remove any double quotes from a string

utf8info

returns hex and int code for each char in string in a vertical list

echo utf8info("すべての数字はどこですか？")
echo utf8info("我们希望情况会尽快好转。")

primey

yields prime numbers from s to e within maxinteger range var maxint = 9223372036854775807 # on 64 system

var cp = 0
for xxx in primey(s=100_000_000,e=100_005_000):
   inc cp
   echo xxx
echo cp," primes found"

let a = createseqfloat(10)
for b in reverse(a): echo b

span

iterator for strings

let s = ".something"
for c in s.span(1, ^1):   # first and index pos must be given
    print c
echo()

cxgetType

answers what type is it question in newer nim versions just use type(s)

procName prints the name of the proc if annoited with pragma {.procName.}

Example .. code-block:: nim proc yippi(s:string) : string {.procName.} = result = s & "007"

printLn(yippi("Mouse"))

toEnum

lifted from nim-blog

Example .. code-block:: nim type Color = toEnum("Red Green Blue Indigo")

aPaletteSample

returns a rand entry (int) from a palette see example at colPalette

bitCheck

check bitsets

clearup

a convenience proc to clear monitor x rows

:: colorsPalette

returns a colorpalette which can be used to iterate over

import nimcx
let z = "The big money waits in the bank"
for _ in 0..10:
   printLn(z,colPalette("pastel",getRndInt(0,colPaletteLen("pastel") - 1)),styled={styleReverse})
   print(cleareol)
doFinish()

:: colPalette

returns a specific color from the palette which can be used in print statements

if n > larger than palette length the first palette entry will be used

import nimcx
cleanScreen()
decho()
var mycol = "light"
mycol = mycol.lowerCase()
let somesample = aPaletteSample(mycol)
printLn($somesample & "th color of the " & mycol & " palette  ( index starts with 0 )", colPalette(mycol,somesample))
printLn("Name of the " & $somesample & "th entry : " & colPaletteName(mycol,somesample))
echo()
printLn("Random color of the " & mycol & " palette ", colPalette(mycol,aPaletteSample(mycol)))
printLn("Length of " & mycol & " palette: " & $colPaletteLen(mycol) & " ( index starts with 0 )" )
echo()
loopy2(0,colPaletteLen(mycol)):
    printLn("Here we go " & rightarrow * 3 & spaces(2) & colPaletteName(mycol,xloopy), colPalette(mycol,xloopy))
doFinish()

colPaletteLen

returns the len of a colPalette of colors in colorNames

colPaletteName

returns the actual name of the palette entry n eg. "mediumslateblue" see example at colPalette

curBkn

mirrors terminal Backward

curDn

mirrors terminal Down

curOff

off , mirrors function hideCursor from terminal.nim

curOn

on , mirrors function showCursor from terminal.nim

currentLine

simple template to return line number , maybe usefull for debugging

curSet

mirrors terminal setCursorPos at x,y position

curSetx

mirrors terminal setCursorXPos

curUp

mirrors terminal Up