#Lilliput 4.0.3
##ChangeLog
######4.0.3
- Forgot to push some changes
######4.0.2
- Remove usages of @inline(__always), will not compile on Linux
- Fixed POSIXError so that it will compile on Linux
######4.0.1
- Performance enhancements (10+ seconds on a project I'm working on)
######4.0.0
- Got rid of ByteSize, FilePosition, and FilePath abstractions.
- Renamed ByteBuffer to UnsafeOrderedBuffer.
- Renamed Buffer to UnsafeBuffer.
- No longer attempt to work with Foundation, the API is awkward and it currently has bugs.
- Fixed permission issue with creating files using POSIXFileSystem.
- Removed the limit and mark functionality from UnsafeOrderedBuffer.
- Fix missing shared scheme required for Carthage support.
- Rebuilt project file using Xcode 8.1 version of SwiftPM.
######3.0.0
- Updated to Swift 3.
- Support for Swift Package Manager.
- Foundation Data now conforms to Buffer protocol.
######2.0.0
- Added back in support for reading and writing files based on a generic protocols so that it should be easy to port to any operating system. Currently supports POSIX on Linux and OS X.
- Added protocol to abstract out a generic memory buffer that tracks its size, and a protocol to abstract out generating buffers. Currently supports POSIX memory allocation on Linux and OS X.
- Byte buffer now takes its byte order as a generic parameter, this should speed up operations as order is now known at compile time.
- Simplified byte order to just use 3 swap methods.
- Removed hex, oct, etc. string conversion utility methods.
######1.1.3 Provide accessor for direct access to the buffer's memory.
######1.1.2 Forgot to update README.
######1.1.1 Minor improvements and fixes.
######1.1.0 Updated to support Swift 2.
######1.0.5 Have to check for "arm" also to prevent compile errors on 32-bit devices.
######1.0.4 Missed two more tests that will not compile on 32-bit devices.
######1.0.3 Add compile configuration protection around tests that won't compile on 32-bit devices.
######1.0.2 Attempting to allow building for both iOS and OSX using one project file.
Description
Lilliput is a native Swift framework for working with binary data of varying endianness. For example you can use it to do custom loading of PNG files which are written in big endian byte order, or tinker with reverse engineering game data files which is what I use it for. Functionality is loosely based on similar functionality found in Java.
##Examples
Putting and getting a big endian 32 bit integer
let memory = POSIXMemory()
let buffer = memory.buferWithSize(100, order: BigEndian.self)
buffer.putUInt32(1024) // Put this value at the current position of the buffer
buffer.flip() // Reset the position to 0 and set the limit to 4 (the amout of bytes written)
let value = buffer.getUInt32() // Get the value at the current position of the buffer
Rough parsing of a PNG file
let filesystem = POSIXFileSystem()
let path = filesystem.parsePath("image.png")
let channel = try filesystem.openPath(path, [.Read])
let memory = POSIXMemory()
let buffer = memory.buferWithSize(4096, order: BigEndian.self)
let bytesRead = try channel.readByteBuffer(buffer)
if bytesRead < PNGHeaderLength {
throw PNGError.MissingHeader
}
buffer.flip() // Must flip before reading after you fill the buffer
let signature = buffer.getUInt8(8)
if signature != [UInt8][137, 80, 78, 71, 13, 10, 26, 10] {
throw PNGError.NotAPNG
}
let chunkLength = buffer.getUInt32()
let chunkType = buffer.getUInt8(4)
let chunkData = buffer.getUInt8(chunkLength)
let chunkCRC = buffer.getUInt32()
##Installation
Can install via Carthage, or by dragging and dropping the project file into your project.
##Contact
##License
Lilliput is available under the MIT license. See the LICENSE file for more info.