Change Log

0.11.0

Released on 2020.01.08

• Improve ColumnFamilyOptions by @jurmous in PR #19
  • Add compactionStyle setting
  • Change maxBytesForLevelMultiplier to a double to match internal type
  • Add missing level0FileNumCompactionTrigger implementation
• Expand WriteOptions with noSlowdown and lowPriority options by @jurmous in PR #21
• Expand RocksDBIterator with seekForPrev and status methods by @jurmous in PR #22
• Expand CompactRangeOptions by @jurmous in PR #25
  • allowWriteStall, maxSubcompactions, targetPathId, exclusiveManualCompaction
• Removed redundant mem-copy in Iterator and improved release semantics in enumerate methods by @myeyesareblind in PRs #27 & #28
• Fix bottommostLevelCompaction switch statement by @jurmous in PR #20

Updated

• Project settings to Xcode11

0.10.0

Released on 2019.09.29

• Updated to RocksDB 6.2.4
  • Thanks to @jurmous in PR #18

0.9.0

Released on 2017.05.25

• RocksDB Version: 5.13.1: facebook/rocksdb@c60df9d

Added

• CocoaPods integration

  • Spec & Scripts by @rob-keepsafe in #9

• RocksDB isClosed method to check if the database instance is still open.

  • Added by @rob-keepsafe in #11

Updated

• Project settings to Xcode9
• Tests to Swift4 syntax

0.8.0

Released on 2017.07.13

• RocksDB Version: 5.4.6: facebook/rocksdb@6e05979

Updated

• Updated Column Family options:
  • uint32_t memtablePrefixBloomProbes ~> double memtablePrefixBloomSizeRatio
  • size_t memtablePrefixBloomHugePageTlbSize ~> size_t memtableHugePageTlbSize
• Updated Statistics tickers and histograms

Removed

• Removed obsolete DB options:
  • BOOL disableDataSync
• Removed obsolete Column Family options:
  • int expandedCompactionFactor
  • int sourceCompactionFactor
  • int maxGrandparentOverlapFactor
  • BOOL verifyChecksumsInCompaction
  • BOOL filterDeletes
  • uint32_t memtablePrefixBloomBits
  • uint32_t minPartialMergeOperands

0.7.0

Released on 2017.02.19

• RocksDB Version: 4.6.1: facebook/rocksdb@8d7926a

Added

• Missing nullability annotations and light-weight generics throughout code base
• New playground content

Updated

• Project for Xcode 8
• Swift tests for Swift 3
• Playground contents and syntax for Swift 3
• Travis config for iOS 10.2, macOS 10.12
• Deployment targets to macOS 10.10, iOS 9.0

Removed

• Removed the deprecated timeoutHint option
• Removed the deprecated maxMemCompactionLevel option

Breaking Changes

The built-in encoding/decoding of keys and values via the encoding options is completelty removed from this release. The API is completely NSData-based now.

• Removed built-it Key/Value Encoders and Decoders
  • The conversions of custom types to/from NSData is the responsibility of the caller
• Removed EncodingOptions
• Removed all methods depending on EncodingOptions and the built-in key/value encoding and all of the their variants:
  • setObject:forKey:
  • deleteObjectForKey:
  • objectForKey:
  • mergeObject:forKey:
  • mergeOperation:forKey:
• Refactored all Iterator, Key Comparator and Merge Operator methods accordingly
• Removed NSNumber Key-Comparators
• Rename method for setting up default read & write options from setDefaultReadOptions:andWriteOptions: to setDefaultReadOptions:writeOptions:
  • The custom Swift equivalent is setDefault(readOptions:writeOptions:)

0.6.0

Released on 2016.06.12

• RocksDB Version: 4.6.1: facebook/rocksdb@8d7926a

Hotfix

• Removed Cocoapods badges from README

0.6.0

Released on 2016.06.12

• RocksDB Version: 4.6.1: facebook/rocksdb@8d7926a

Added

• Support for opening the database in read-only mode
• Support for Write Batch with Index and Write Batch Iterator
• Support for Range Compaction operations
• Nullability annotations
  • Better compatibility with Swift
• New statistics and counters
• Cocoapods Podspec
• Travis integration

Breaking Changes

• RocksDB initializers were changed to class instead of instance methods
• Removed RocksDB methods without error parameter
  • Better compatibility with Swift's error-handling model
• Refactored all RocksDB methods so that the error parameter is the last
  • Better compatibility with Swift's error-handling model
• Removed Column Family Metadata from iOS target
• RocksDBIteratorKeyRange is refactored to RocksDBKeyRange
  • Key ranges are used not only for iterations but also for compaction jobs
  • Empty-range constant is refactored to open-range, since it represents a range containing all the keys
• ObjectiveRocks builds frameworks now instead of static libraries

0.5.0

Released on 2016.07.30

• RocksDB Version: 3.11: facebook/rocksdb@812c461

Added

• Source code documentation

Removed

• Removed + (instancetype)LRUCacheWithCapacity:numShardsBits:removeScanCountLimit: RocksDB Cache initializer
  • No longer available since: facebook/rocksdb@c88ff4c

0.4.0

Released on 2015.01.17

• RocksDB Version: 3.9: facebook/rocksdb@b89d58d

All headers are refactored in this release to provide a pure Objective-C interface for Swift compatibility.

Added

• Basic support for RocksDB Env for configuring priority thread pools
• Support for querying the Threads Status
• Options for Background Compactions and Background Flushes
• Iterator methods for key-value iteration
• Support for Column Family Metadata
• Swift tests

Fixed

• Typo in method name in Filter Policy class
• Typo in method name to retrieve column families in RocksDB class

Changed

• Updated Thread Status API
  • Adapted according to the changes introduces in: facebook/rocksdb@bf287b7

0.3.0

Released on 2015.01.05

• RocksDB Version: 3.9: facebook/rocksdb@a801c1f

This is the first public release of ObjectiveRocks.

Added

• Database backup and backup-info support
• Database Checkpoints
• Support for collecting database statistics, histograms and properties
• Column Family options
• Support for Column Family memtable rep factories
• Support for Block-based, Plain-Table and Cuckoo-Table factories
• Support for RocksDB Cache
• Support for RocksDB Filter Policy

0.2.0

Released on 2015.02.01

• RocksDB Version: 3.9: facebook/rocksdb@a801c1f

Added

• Column Families implementation
• Implementation for Generic Merge Operators
• Built-In comparator types for NSString, NSNumber, and RocksDB's own native byte-wise comparator
• Built-In Key-Value encoders and decoders for NSString and NSJSONSerializable types
• Write Batch methods for merge operations
• Prefix-based seek iterations
• Tests

0.1.0

Released on 2015.12.23

• RocksDB Version: 3.9: facebook/rocksdb@9cda7cb

First release of ObjectiveRocks featuring basic RocksDB functionality:

• Opening and closing RocksDB instances
• Basic DB options
• Put, Get and Delete operations
• Read and Write options that are specific to single operations
• Atomic updates via Write Batches
• Key-Value encoders and decoders for converting arbitrary objects to and from NSData
• Database iteration support
• Database Snapshots - Read-only view over the entire DB
• Key Comparators support - For custom key-ordering in the DB
• Associative Merge Operators support - Atomic read-modify-write operations