48 replies to this topic

[Xtansia]

This my String Utils API.

Stats:
-Function Count = 43
-Line Count = 953
-Character Count = 34110
-File Size = 34KB
-Local Functions/Variables(Used by string functions) = 45

Function Listing:

Spoiler

toCharTable(str) --Returns table of @str's chars
toByteTable(str) --Returns table of @str's bytes
fromCharTable(chars) --Returns str made of chracters in @chars
fromByteTable(bytes) --Returns str made of bytes in @bytes
contains(str,find) --Returns true if @str contains @find
startsWith(str,Start) --Check if @str starts with @Start
endsWith(str,End) --Check if @str ends with @End
trim(str) --Trim @str of initial/trailing whitespace
firstLetterUpper(str) --Capitilizes first letter of @str
titleCase(str) --Changes @str to title case
isRepetition(str, pat) --Checks if @str is a repetition of @pat
isRepetitionWS(str, pat) --Checks if @str is a repetition of @pat seperated by whitespaces
urlDecode(str) --Url decodes @str
urlEncode(str) --Url encodes @str
isEmailAddress(str) --Checks if @str is a valid email address
chunk(str, size) --Splits @str into chunks of length @size
find(str, match, startIndex) --Finds @match in @str optionally after @startIndex
seperate(str, divider) --Seperates @str on @divider
replace(str, from, to) --Replaces @from to @to in @str
jumble(str) --Jumbles @str
toBase(str, base) --Encodes @str in @base
fromBase(str, base) --Decodes @str from @base
toBinary(str) --Encodes @str in binary
fromBinary(str) --Decodes @str from binary
toOctal(str) --Encodes @str in octal
fromOctal(str) --Decodes @str from octal
toHex(str) --Encodes @str in hex
fromHex(str) --Decodes @str from hex
toBase36(str) --Encodes @str in Base36
fromBase36(str) --Decodes @str from Base36
toBase32(str) --Encodes @str in Base32
fromBase32(str) --Decodes @str from Base32
toBase64(str) --Encodes @str in Base64
fromBase64(str) --Decodes @str from Base64
rot13(str) --Rot13s @str
rot47(str) --Rot47s @str
SHA1(str) --Returns SHA1 Hash of @str
CRC32(str) --Returns CRC32 Hash of @str
FCS16(str) --Returns FCS16 Hash of @str
FCS32(str) --Returns FCS32 Hash of @str
encrypt(str, key) --Encrypts @str with @key
decrypt(str, key) --Decrypts @str with @key
setRandSeed(seed) --Sets random seed to @seed

Example Output:

Spoiler

----------
toCharTable("Hello")
1-H
2-e
3-l
4-l
5-o
----------
fromCharTable()
Hello
----------
toByteTable("Hello")
1-72
2-101
3-108
4-108
5-111
----------
fromByteTable()
Hello
----------
contains("Hello", "Hell")
true
----------
startsWith("Hello", "H")
true
----------
endsWith("Hello", "o")
true
----------
trim(" Hello ")
Hello
----------
firstLetterUpper("hello")
Hello
----------
titleCase("hello world, how are you")
Hello World, How Are You
----------
isRepetition("HelloHelloHello", "Hello")
true
----------
isRepetitionWS("Hello Hello Hello", "Hello")
true
----------
urlEncode("Hello There World")
Hello+There+World
----------
urlDecode()
Hello There World
----------
isEmailAddress("[email protected]")
true
----------
chunk("123456789", 3)
1-123
2-456
3-789
----------
find("Hello World HeHe", "World")
7
----------
seperate("1.2.3.4.5", ".")
1-1
2-2
3-3
4-4
5-5
----------
replace("# # # #"," ","*")
#*#*#*#
----------
jumble("Hello World")
oHlord lWel
----------
toBase("Hello", 13)
57:7A:84:84:87
----------
fromBase()
Hello
----------
toBinary("Hello")
1001000:1100101:1101100:1101100:1101111
----------
fromBinary()
Hello
----------
toOctal("Hello")
110:145:154:154:157
----------
fromOctal()
Hello
----------
toHex("Hello")
48:65:6C:6C:6F
----------
fromHex()
Hello
----------
toBase36("Hello")
20:2T:30:30:33
----------
fromBase36()
Hello
----------
toBase32("Hello")
JBSWY3DP
----------
fromBase32()
Hello
----------
toBase64("Hello")
SGVsbG8=
----------
fromBase64()
Hello
----------
rot13("Hello")
Uryyb
----------
rot47("Hello")
[email protected]
----------
SHA1("Hello")
f7ff9e8b7bb2e09b70935a5d785e0cc5d9d0abf0
----------
CRC32("Hello")
4157704578
----------
FCS16("Hello")
21548
----------
FCS32("Hello")
3671287311
----------
encrypt("Hello", "Key")
Q4Y3F3X495Z3L476L5Z2G374L4K4L4
----------
decrypt()
Hello
----------

To install:

Spoiler

-Download Zip
-place the StrUtils file into mods/ComputerCraft/lua/rom/apis/
-Load up CC

To use:

Spoiler

-Use it just like any other API eg.
s,e = StrUtils.find("Hello", "e")
or
digits = StrUtils.seperate("0/65/0", "/")
or
encoded = StrUtils.encrypt("Hello", "CoolKey")

License:

Spoiler

Copyright © 2012 Thomas Farr a.k.a tomass1996 [[email protected]]

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and
associated documentation files (the "Software"), to deal in the Software without restriction,
including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense,
copies of the Software, and to permit persons to whom the Software is furnished to do so,
subject to the following conditions:

-The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
-Visible credit is given to the original author.
-The software is distributed in a non-profit way.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE
WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

If you need clarification on something just ask.
If you find any bugs or errors please report them.

Download:
GitHub
BitBucket
Projects:
GitHub
BitBucket

[FuzzyPurp]

Testing*

[Espen]

@tomass1996:
These are some very useful functions.
But why did you hide their source as bytecode? Don't you want other people to understand the inner workings?
Don't get me wrong, I'm not trying to get at you or sth. I'm just genuinely curious as to why you would hide these algorithms, most of which are already known anyway?

[Xtansia]

Espen, on 07 February 2012 - 07:28 PM, said:

@tomass1996:
These are some very useful functions.
But why did you hide their source as bytecode? Don't you want other people to understand the inner workings?
Don't get me wrong, I'm not trying to get at you or sth. I'm just genuinely curious as to why you would hide these algorithms, most of which are already known anyway?

There is no real reason as such.
The only functions that would have a legit reason for hiding is the encryption and decryption algorithms,
I will probably end up posting it as standard code eventually anyway.

[Casper7526]

Basically he just learned about compiled bytecode and wanted to play with it and use it in an application />

[Xtansia]

Casper7526, on 08 February 2012 - 03:04 AM, said:

Basically he just learned about compiled bytecode and wanted to play with it and use it in an application />

That too...

[Xtansia]

Just realised there was an error in the API file where the path for the lib was rom/libs/StringUtils.lib instead of rom/libs/StringUtil.lib

So put up a new zip ppl may have gotten this error if you did just change the path in StrUtil file.

[Xtansia]

Another quick patch,
Minor stuff.

[Espen]

tomass1996, on 08 February 2012 - 02:53 AM, said:

Espen, on 07 February 2012 - 07:28 PM, said:

@tomass1996: These are some very useful functions. But why did you hide their source as bytecode? Don't you want other people to understand the inner workings? Don't get me wrong, I'm not trying to get at you or sth. I'm just genuinely curious as to why you would hide these algorithms, most of which are already known anyway?

There is no real reason as such. The only functions that would have a legit reason for hiding is the encryption and decryption algorithms, I will probably end up posting it as standard code eventually anyway.

Casper7526, on 08 February 2012 - 03:04 AM, said:

Basically he just learned about compiled bytecode and wanted to play with it and use it in an application />

*Understanding nod* .. as I said I was just curious and thought as much (it being programming exercise). Thanks for clarifying!

tomass1996, on 08 February 2012 - 08:29 AM, said:

Another quick patch, Minor stuff.

Hehe, and as long as the source is closed you're the only person able to both notice and fix these things.
That (and my general curiosity of how things work) is the main reason why I asked in the first place. />

But I have to respectfully disagree on what you said about the encryption code needing obfuscation.
The security of an encryption algorithm should never hinge on the obscurity of its inner workings, but on the key you use to encrypt a message with it.
Well, only if you want to be as secure as possible in principle as well.
Practically though, I can't really imagine anyone encrypting serious data. Most will use it for RPG reasons, so the real security might not be of major concern.^^

But If you're interested, here's some more interesting info about it:
http://en.wikipedia....fs%27_principle
http://en.wikipedia....ty_by_obscurity

One can never know enough. />
Thanks again for clarification, take care!

[Xtansia]

Yay Open Source!

[Xtansia]

Added More functions,

Spoiler

startsWith(string,Start) --Check if @string starts with @Start
endsWith(string,End) --Check if @string ends with @End
trim(string) --Trim @string of initial/trailing whitespace
firstLetterUpper(string) --Capitilizes first letter of @string
titleCase(string) --Changes @string to title case
isRepetition(string, pat) --Checks if @string is a repetition of @pat
isRepetitionWS(string, pat) --Checks if @string is a repetition of @pat seperated by whitespaces
urlDecode(string) --Url decodes @string
urlEncode(string) --Url encodes @string
isEmailAddress(string) --Checks if @string is a valid email address
setRandSeed(seed) --Sets random seed to @seed

Zipfile now also contains a function listing for quick reference.

[MewK]

Hey tomass,

I'm planning to include your library in one of my projects. That's why I wanted to ask if you have any problems with that and furthermore under what kind conditions/license have you released this lib? My plan is to release my project under the MIT license with full credits. Would that be okay with you?

-MewK

[ThePH]

NOOOOO !
You outran me, I was gonna post something similar />
nice work though />

Can I use some of it in my encoder API? (I will give you credit /> )

[Xtansia]

MewK, on 01 March 2012 - 09:48 AM, said:

Hey tomass,

I'm planning to include your library in one of my projects. That's why I wanted to ask if you have any problems with that and furthermore under what kind conditions/license have you released this lib? My plan is to release my project under the MIT license with full credits. Would that be okay with you?

-MewK

Hey that would be fine with me,
I need to update the op but it's effectively the same license as here http://www.computerc...__fromsearch__1
It's a slightly altered mit license, basicly just that you can't sell my stuff.
BTW what's your project?

[Xtansia]

ThePH, on 01 March 2012 - 10:03 AM, said:

NOOOOO !
You outran me, I was gonna post something similar />
nice work though />

Can I use some of it in my encoder API? (I will give you credit /> )

Thnx.
Same as above read the license in that post I'm going to update this op in the morning. Aslong as I am credited and you list/mark/flag the functions that are from mine.

[MewK]

tomass1996, on 01 March 2012 - 12:15 PM, said:

Hey that would be fine with me,
I need to update the op but it's effectively the same license as here http://www.computerc...__fromsearch__1
It's a slightly altered mit license, basicly just that you can't sell my stuff.
BTW what's your project?

My main project is still the Midcraft Commander.

However I'm working on a API project right now. It will be called rwtk (Redworks Toolkit) and my plan is to integrate and replace the RW API.
The API will include an event-driven-application-framework for GUI based apps, a basic drawing lib that will be used by the app-framework, a small core framework for basic stuff like class-handling. To add more functionality I'm looking for good libraries to add. your string lib would be the first candidate, a proper turtle lib would be a next candidate. I will port Midcraft Commander to the new API and step by step all Redworks programs. A long term goal would be to implement a rwtk.netfs lib, that will allow to do file system actions across the network.

It is important to me that the new API is good enough to be the defacto standard for CC software development. But to achieve that I have to get as many ppl on board as possible. The project will be hosted on GitHub, will have a full documentation and I hope that a few ppl want to help developing it.

[Xtansia]

MewK, on 01 March 2012 - 01:24 PM, said:

tomass1996, on 01 March 2012 - 12:15 PM, said:

Hey that would be fine with me.
I need to update the op but it's effectively the same license as here http://www.computerc...__fromsearch__1
It's a slightly altered mit license, basicly just that you can't sell my stuff.
BTW what's your project?

My main project is still the Midcraft Commander.

However I'm working on a API project right now. It will be called rwtk (Redworks Toolkit) and my plan is to integrate and replace the RW API.
The API will include an event-driven-application-framework for GUI based apps, a basic drawing lib that will be used by the app-framework, a small core framework for basic stuff like class-handling. To add more functionality I'm looking for good libraries to add. your string lib would be the first candidate, a proper turtle lib would be a next candidate. I will port Midcraft Commander to the new API and step by step all Redworks programs. A long term goal would be to implement a rwtk.netfs lib, that will allow to do file system actions across the network.

It is important to me that the new API is good enough to be the defacto standard for CC software development. But to achieve that I have to get as many ppl on board as possible. The project will be hosted on GitHub, will have a full documentation and I hope that a few ppl want to help developing it.

Cool,
I'm going to do a few wee updates to this,
And I'll be hosting it on github for easier updating.

[Biohazard]

Looks useful />. I'm downloading it, and good luck with extending it />

[FuzzyPurp]

MewK, on 01 March 2012 - 01:24 PM, said:

tomass1996, on 01 March 2012 - 12:15 PM, said:

Hey that would be fine with me,
I need to update the op but it's effectively the same license as here http://www.computerc...__fromsearch__1
It's a slightly altered mit license, basicly just that you can't sell my stuff.
BTW what's your project?

My main project is still the Midcraft Commander.

However I'm working on a API project right now. It will be called rwtk (Redworks Toolkit) and my plan is to integrate and replace the RW API.
The API will include an event-driven-application-framework for GUI based apps, a basic drawing lib that will be used by the app-framework, a small core framework for basic stuff like class-handling. To add more functionality I'm looking for good libraries to add. your string lib would be the first candidate, a proper turtle lib would be a next candidate. I will port Midcraft Commander to the new API and step by step all Redworks programs. A long term goal would be to implement a rwtk.netfs lib, that will allow to do file system actions across the network.

It is important to me that the new API is good enough to be the defacto standard for CC software development. But to achieve that I have to get as many ppl on board as possible. The project will be hosted on GitHub, will have a full documentation and I hope that a few ppl want to help developing it.

Sweet, i hope tomass can get on board with us />

[Xtansia]

Another wee update:
Added:
toCharTable(string) --Returns table of @string's chars
toByteTable(string) --Returns table of @string's bytes
fromCharTable(chars) --Returns string made of chracters in @chars
fromByteTable(bytes) --Returns string made of bytes in @bytes

Now hosted on GitHub.
Added license to op.

FuzzyPurp, on 01 March 2012 - 08:54 PM, said:

Spoiler

MewK, on 01 March 2012 - 01:24 PM, said:

tomass1996, on 01 March 2012 - 12:15 PM, said:

Hey that would be fine with me,
I need to update the op but it's effectively the same license as here http://www.computerc...__fromsearch__1
It's a slightly altered mit license, basicly just that you can't sell my stuff.
BTW what's your project?

My main project is still the Midcraft Commander.

However I'm working on a API project right now. It will be called rwtk (Redworks Toolkit) and my plan is to integrate and replace the RW API.
The API will include an event-driven-application-framework for GUI based apps, a basic drawing lib that will be used by the app-framework, a small core framework for basic stuff like class-handling. To add more functionality I'm looking for good libraries to add. your string lib would be the first candidate, a proper turtle lib would be a next candidate. I will port Midcraft Commander to the new API and step by step all Redworks programs. A long term goal would be to implement a rwtk.netfs lib, that will allow to do file system actions across the network.

It is important to me that the new API is good enough to be the defacto standard for CC software development. But to achieve that I have to get as many ppl on board as possible. The project will be hosted on GitHub, will have a full documentation and I hope that a few ppl want to help developing it.

Sweet, i hope tomass can get on board with us />

Yeh I'm all for it,
I'm not the most amazing at lua but I support it and the use of my api,
I'll contribute whatever I can.