Reactive type-safe Scala driver for Cassandra/Datastax Enterprise
Scala Other
Latest commit cc07de1 Feb 21, 2017 @alexflav23 alexflav23 committed on GitHub Feature/optional json cols (#630)
* Adding support for optional json cols

* Adding support and tests for optional JSON columns

* More basic linting

* Fixing some more tests

* Cleaning up old tests

* Fixing support for optional JSON columns

* Fixing primary key issue with casting

* Fixing some of the tests

* Removing overloaded weird definitions

* Making a KeySpace serialization the best thing in town

* Bumping version to next minor due to backwards incompatibility [version skip]

* Trying to fix tests

* Cleaning up and fixing tests

README.md

phantom

Build Status Coverage Status Codacy Rating Maven Central Bintray ScalaDoc Gitter

Reactive type-safe Scala driver for Apache Cassandra/Datastax Enterprise

To stay up-to-date with our latest releases and news, follow us on Twitter: @outworkers.

If you use phantom, please consider adding your company to our list of adopters. Phantom is and will always be open source, but the more adopters our projects have, the more people from our company will actively work to make them better.

phantom

Migrating to phantom 2.0.x series

The new series of phantom introduces several key backwards incompatible changes with previous versions. This was done to obtain massive performance boosts and to thoroughly improve user experience with phantom.

Read the MIGRATION GUIDE for more information on how to upgrade.

Available modules

This is a table of the available modules for the various Scala versions. Not all modules are available for all versions just yet, and this is because certain dependencies have yet to be published for Scala 2.12.

Phantom OSS

Module name Scala 2.10.x Scala 2.11.x Scala 2.12.0
phantom-connectors yes yes yes
phantom-dsl yes yes yes
phantom-jdk8 yes yes yes
phantom-sbt yes no no
phantom-example yes yes no
phantom-thrift yes yes no
phantom-finagle yes yes no
phantom-streams yes yes no

Phantom Pro subscription edition

Modules marked with "x" are still in beta or pre-publishing mode.

Module name Scala 2.10.x Scala 2.11.x Scala 2.12.0 Release date
phantom-dse yes yes yes Released
phantom-udt yes yes yes Released
phantom-autotables x x x May 2017
phantom-graph x x x April 2017
phantom-spark x x x July 2017
phantom-solr x x x July 2017
phantom-migrations x x x September 2017

Using phantom

Scala 2.10, 2.11 and 2.12 releases

We publish phantom in 2 formats, stable releases and bleeding edge.

  • The stable release is always available on Maven Central and will be indicated by the badge at the top of this readme. The Maven Central badge is pointing at the latest version

  • Intermediary releases are available through our OSS Bintray repo available at Resolver.bintrayRepo("outworkers", "oss-releases") or https://dl.bintray.com/outworkers/oss-releases/. The latest version available on our Bintray repository is indicated by the Bintray badge at the top of this readme.

How phantom compares

To compare phantom to similar tools in the Scala/Cassandra category, you can read more here.

Latest versions

The latest versions are available here. The badges automatically update when a new version is released.

  • Latest stable version: Maven Central (Maven Central)
  • Bleeding edge: Bintray (OSS releases on Bintray)

Tutorials on phantom and Cassandra

For ease of use and far better management of documentation, we have decided to export the README.md to a proper Wiki page, now available here.

The following are the current resources available for learning phantom, outside of tests which are very useful in highlighting all the possible features in phantom and how to use them.

This is a list of resources to help you learn phantom and Cassandra:

Issues and questions

back to top

We love Cassandra to bits and use it in every bit of our stack. phantom makes it super trivial for Scala users to embrace Cassandra.

Cassandra is highly scalable and it is by far the most powerful database technology available, open source or otherwise.

Phantom is built on top of the Datastax Java Driver, which does most of the heavy lifting.

We are very happy to help implement missing features in phantom, answer questions about phantom, and occasionally help you out with Cassandra questions! Please use GitHub for any issues or bug reports.

Adopters

Here are a few of the biggest phantom adopters, though the full list is far more comprehensive.

Starbucks Microsoft CreditSuisse ING UBS Wincor Nixdorf Paddy Power Strava Equens Pellucid Analytics Anomaly42 ChartBoost Tecsisa Mobli VictorOps Socrata Sphonic

License and copyright

Phantom is distributed under the Apache V2 License.

  • Outworkers, Limited is the copyright holder.

  • You can use phantom in commercial products or otherwise.

  • We strongly appreciate and encourage contributions.

  • All paid for features are published and sold separately as phantom-pro, everything that is currently available for free will remain so forever.

If you would like our help with any new content or initiatives, we'd love to hear about it!

Contributors

back to top

Phantom was developed at outworkers as an in-house project. All Cassandra integration at outworkers goes through phantom, and nowadays it's safe to say most Scala/Cassandra users in the world rely on phantom.

Copyright

back to top

Special thanks to Viktor Taranenko from WhiskLabs, who gave us the original idea, and special thanks to Miles Sabin and team behind Shapeless, where we shamelessly stole all the good patterns from.

Copyright © 2013 - 2017 outworkers.

Contributing to phantom

back to top

Contributions are most welcome! Use GitHub for issues and pull requests and we will happily help out in any way we can!