Kirsten Hunter

<p>As a DataStax Developer Advocate, my job is to help our amazing teams provide you with the best possible experience with Cassandra and our products.</p>

<p>Datastax <a href="https://auth.cloud.datastax.com/auth/realms/CloudUsers/protocol/openid-connect/registrations?client_id=auth-proxy&amp;response_type=code&amp;scope=openid+profile+email&amp;redirect_uri=https://astra.datastax.com&amp;utm_source=workshop&amp;utm_medium=referral&amp;utm_campaign=cassandra-workshop">Astra</a>&nbsp;is a multi-cloud&nbsp;Database as a Service (DBaaS). In addition to great <a href="https://docs.astra.datastax.com/docs">documentation</a>, Astra offers a robust free tier that can run small production workloads, pet projects, or just let you play—all for free, no credit card required. Cassandra can be tricky for hardcore SQL developers, because it uses a different slightly different query language (CQL), but when you get Astra, <a href="https://stargate.io">Stargate</a> is there to let you interact with your data through APIs. Our open source Stargate product provides REST, GraphQL, and schemaless document APIs in addition to native language drivers. If you like them but don’t want to use our products, that’s fine! &nbsp;It’s completely open source and you can implement it on your own system.</p>

<p>One of the things I noticed when I arrived at DataStax is that our tutorials rely heavily on curl for performing commands against our APIs. I prefer HTTPie, a similar tool designed for REST API interaction.So I created an authentication plugin for the HTTPie tool that stores your variables and lets you make requests like:</p>

<pre>
http:/v2/schemas/keyspaces</pre>

<p>I’ve put together a <a href="https://katacoda.com/datastax/scenarios/httpie-astra">Katacoda scenario</a> for you to see how everything works. If you want to implement it locally, here are the instructions:</p>

<p>The first secret to this is an rc file (~/.astrarc), which keeps track of your DB, region, username, and password, and auto-refreshes your token. You can have as many sections in this file as works for you—it’s just an INI-style configuration file.</p>

<p>The second secret is the HTTPie configuration file, in ~/.config/httpie/config.json</p>

<p>My configuration is what you see here; I have the “fruity” color scheme, my default auth-type is astra, and the section of the .astrarc file is “default”.</p>

<div class="code">
<div class="code__heading"><span>config.JSON</span><button class="code__copy">Copy</button></div>

<div class="code__body">
<pre>
      <code class="language-ini">
{ &nbsp; &nbsp; "default_options": [ &nbsp; &nbsp; &nbsp; "--style=fruity", &nbsp; &nbsp; &nbsp; "--auth-type=astra", &nbsp; &nbsp; &nbsp; "--auth=default:" &nbsp; &nbsp; ] }
      </code>
    </pre>
</div>
</div>

<p>My goal here is to make it so you can bounce around between REST and GraphQL queries, get nicely formatted JSON results, and perhaps use jq to pare them down—but mostly I want for the tool to get out of your way.</p>

<p>Interested? At this point httpie-astra requires python 3.5, but if you want me to make it support 2.7, please just let me know in the <a href="https://community.datastax.com/index.html">Datastax Community</a> or on Discord.</p>

<p>You can get it through github:</p>

<pre>
git clone https://synedra-datastax/httpie-astra</pre>

<p>Or with pip:</p>

<pre>
pip3 install httpie-astra</pre>

<p>Once you’ve got it installed, get your environment set up by making a simple call like:</p>

<pre>
http --auth-type astra -a default: :/v2/schemas/keyspaces</pre>

<p>This will give you instructions to get all your variables set up.</p>

<p>Let’s take a look at an example from our Astra REST documentation.</p>

<p>The curl command looks like this:</p>

<pre>
curl --request GET \
--url https://${ASTRA_CLUSTER_ID}-${ASTRA_CLUSTER_REGION}.apps.astra.datastax.com/api/restv2/schemas/keyspaces/${ASTRA_DB_KEYSPACE}/tables/products

&nbsp;\

&nbsp; --header 'accept: application/json' \

&nbsp; --header 'x-cassandra-request-id: {unique-UUID}' \

&nbsp; --header "x-cassandra-token: ${ASTRA_AUTHORIZATION_TOKEN}"
</pre>

<p><br />
Then it gives you back a single line JSON doc.</p>

<div class="code">
<div class="code__heading"><span>JSON</span><button class="code__copy">Copy</button></div>

<div class="code__body">
<pre>
      <code class="language-ini">
{"data":{"name":"products","keyspace":"tutorial","columnDefinitions":[{"name":"id","typeDefinition":"uuid","static":false},{"name":"created","typeDefinition":"timestamp","static":false},{"name":"description","typeDefinition":"varchar","static":false},{"name":"name","typeDefinition":"varchar","static":false},{"name":"price","typeDefinition":"decimal","static":false}],"primaryKey":{"partitionKey":["id"],"clusteringKey":[]},"tableOptions":{"defaultTimeToLive":0,"clusteringExpression":[]}}}
      </code>
    </pre>
</div>
</div>

<p>The httpie command already knows a lot of this information, so the call is much simpler. I’m using the config.json I described above to set my auth-type and config section. I’ll show this output as a screen shot because it’s really easy to understand:</p>

<p><img alt="HTTPie" data-entity-type="file" data-entity-uuid="37c823ee-049a-4d24-bad3-54d594a7c73a" src="https://www.datastax.com/sites/default/files/inline-images/HTTPie.png" /></p>

<p>We’re on the job, getting the Stargate examples and Astra API examples to include HTTPie tabs, but in the meantime if you’re having fun with this, please let me know in the community or discord, and let’s make this rock for you!</p>


Blasting Off into Stargate using HTTPie

Kirsten Hunter

Share

Share

More Technology

Knowledge Graphs for RAG without a GraphDB

How Winweb Built its AI Assistant with DataStax Astra DB and LangChain

Vercel + Astra DB: Get Data into Your GenAI Apps Fast

Simplifying Agent Development with Astra DB Connector for Vertex AI Search

One-stop Data API for Production GenAI