{"id":20198400,"url":"https://github.com/vast-engineering/athena","last_synced_at":"2025-04-10T10:51:55.537Z","repository":{"id":13630882,"uuid":"16324191","full_name":"vast-engineering/athena","owner":"vast-engineering","description":"A fully asynchronous nonblocking and reactive client library for Apache Cassandra.","archived":false,"fork":false,"pushed_at":"2015-06-03T18:51:47.000Z","size":594,"stargazers_count":24,"open_issues_count":11,"forks_count":2,"subscribers_count":42,"default_branch":"master","last_synced_at":"2025-03-24T09:46:54.089Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Scala","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/vast-engineering.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2014-01-28T20:07:22.000Z","updated_at":"2018-11-06T23:29:25.000Z","dependencies_parsed_at":"2022-08-31T11:23:04.594Z","dependency_job_id":null,"html_url":"https://github.com/vast-engineering/athena","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vast-engineering%2Fathena","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vast-engineering%2Fathena/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vast-engineering%2Fathena/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vast-engineering%2Fathena/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/vast-engineering","download_url":"https://codeload.github.com/vast-engineering/athena/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248203722,"owners_count":21064629,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-14T04:31:06.845Z","updated_at":"2025-04-10T10:51:55.520Z","avatar_url":"https://github.com/vast-engineering.png","language":"Scala","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Athena\n\nThis is a fully asynchronous and nonblocking Cassandra client built on top of the (Excellent) Akka-IO framework.\n\nCurrently, it can create a fault tolerant pool of load balanced connections to a Cassandra cluster, stream queries and marshal results.\n\nWhat doesn't work yet -\n\n* Authentication\n* Connection compression\n* Intelligent (key aware) query routing\n* Documentation - sample code\n\n## Using Athena\n\n[sonatype]: https://oss.sonatype.org/index.html\n\nBinary release artifacts for Scala 2.11.x and 2.10.x are published to the [Sonatype Maven Repository][sonatype]\nand synced to Maven Central. The current release is only available as a SNAPSHOT (for now), but the final 0.3.0\nrelease is imminent.\n\n### SBT builds\n```scala\nlibraryDependencies ++= Seq(\n  \"com.vast\" %% \"athena\" % \"0.3.0-SNAPSHOT\"\n)\n```\n\n### Maven builds\n```xml\n\u003cproperties\u003e\n    \u003cscala.major.version\u003e2.10\u003c/scala.major.version\u003e\n\u003c/properties\u003e\n\n\u003cdependencies\u003e\n    \u003cdependency\u003e\n        \u003cgroupId\u003ecom.vast\u003c/groupId\u003e\n        \u003cartifactId\u003eathena_${scala.major.version}\u003c/artifactId\u003e\n        \u003cversion\u003e0.3.0-SNAPSHOT\u003c/version\u003e\n    \u003c/dependency\u003e\n\u003c/dependencies\u003e\n```\n\n## Usage\n\nTODO: More info here\n\n### Actors\n\nThe high level interface for Athena is through the ClusterConnector actor. This actor models a pool of connections\nto all the hosts in your cluster, and will load balance queries across them in an appropriate fashion.\n\n### Sessions\n\nThere is currently an experimental higher level Session abstraction that models interactions as a series of pipelines,\nwhere a pipeline is simply defined as\n\n```scala\nAthenaRequest =\u003e Future[AthenaResponse]\n```\n\nA Session wraps a pipeline and adds more useful methods on top of it, and also the ability to stream rows back using\nPlay Enumerators. The entirety of this API, however, is really just a prototype and is subject to change across versions\nwith little to no warning.\n\n## Building\nAthena is built with SBT 0.13.x, and is designed to be essentially and out of the box build. You should be able to\ncompile, package and (if needed) deploy locally by simply doing 'sbt publishLocal' from the command line. The\ntest suite requires an active instance of cassandra to run against. Fortunately, the SBT harness is built in such a way\nthat it automatically handles downloading the proper version of cassandra, configuring it, starting the server\nand setting up a test keyspace before the tests run. This instance is then torn down after tests complete. Most of this\nfunctionality is configured using SBT settings - look in project/CassandraUtils.scala for info on how to change it.\nFor example, if you wish to disable the server auto-provisioning to use your own instance, just add\n\n```scala\nimport CassandraUtils.Keys._\n\nprovisionServer := false\n```\n\nto your local.sbt file.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvast-engineering%2Fathena","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvast-engineering%2Fathena","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvast-engineering%2Fathena/lists"}