brs-utils

Utilities for Roku development

This includes:

• A testing framework like jUnit
• A logger inspired in Log4j
• A i18n framework for translations
• A Java like Optional implementation with error handling (since we don't have exceptions)
• An example channel with all the different templates and a video player

buTypeUtils

• isString
• isBool
• isInt
• isArray
• isList
• isFloat
• isDouble
• isComparable
• isNumber
• isDateTime
• isObject
• isUnitialized

buStringUtils

• isEmpty
• intToString
• doubleToString
• floatToString
• arrayToString
• objectToString
• toStr
• equals
• truncate
• capitalize
• split
• contains
• indexOf
• lastIndexOf
• join
• toArray
• reverse
• replace
• toMD5Hash
• toSHA1Hash
• toSHA256Hash
• toSHA512Hash
• substitute
• toString
• isNumeric
• wrap
• initials

buNumbersUtils

• max
• min
• floor
• ceiling
• round
• isOdd
• isEven
• bin2dec
• hex2dec
• rad2deg
• deg2rad
• factorial
• average

buArrayUtils

• equals
• isEmpty
• contains
• indexOf
• add
• replace
• subArray
• toString
• filter

buDeviceUtils

• getAppVersion
• getResolution
• getFirmwareVersion
• getCurrentLanguage
• writeEntry
• readEntry
• listEntries
• listSections
• deleteEntry
• deleteAllEntries

buRandomUtils

• nextInteger
• nextFloat
• nextString
• nextHexString
• uuid

buDateTimeUtils

• compare
• isBetween
• isAfter
• isBefore
• dateOf
• parse
• toMidnight
• duration
• addDays
• addHours
• substractDays
• substractHours
• toString

buValidationUtils

• isEmail
• isURL
• isCreditCard
• lunhCheck

buI18N

Retrieve translation keys from translation files. Usage:

buI18N().get("some.key")
buI18N().get("some.key", "1", "2", "3")
buI18N().plural("some.key", 1)

buOptional

A container object which may or may not contain a Invalid value or an error. If a value is present and there's no error, isPresent() will return true and get() will return the value.

To raise errors:

   function someFunc() as Object
       return buOptional().error("This is an error", 500)
   end function

buSet

A very simplistic Set implementation. Only works with BrightScript primitives

• add
• remove
• get
• contains
• count
• equals
• toString
• filter
• each

buList

A roArray implementation with more functionality. Basically is a wrapper around a normal roArray and buArrayUtils. For example, instead of doing:

arr = [1,2,3,4]
buArrayUtils().toString(arr)

You would do:

arr = buList([1,2,3,4])
arr.toString()

Or more cool stuff

buList([1,2,3,4]).add(6).add(7).filter(...).each(...).toString()

buCache

A Cache singleton for String data (i.e. JSON or XML data) in the Roku tmp: storage

---

Also checkout my Atom plugin for BrightScript