Examples of usage

All of these are subject to change, as the API isn't remotely stable yet.

Example of constructing a service and writing it out:

#include <libsparklepaw/service.h>
 
void main() {
  struct sprkl_tagval_pair pair = {
    .tag = { .upper = 0xFFFFFFFFFFFFFFFF, .lower = 0 },
    .valuesz = 8,
    .value = "hello!!!"
  };
  struct sprkl_record record = {
    .paircnt = 1,
    .pairs = &pair
  };
  uint8_t signature[4] = { 0x12, 0x34, 0x56, 0x78 };
  struct sprkl_service service = {
    .sigsz = sizeof(signature),
    .signature = signature,
    .index = 0x6969,
    .flags = 0,
    .reccnt = 1,
    .records = &record
  };
 
  int n = sprkl_service_write(&service, stdout);
  fprintf(stderr, "\nWrote %d bytes\n", n);
}

Example of reading a service in and printing it for debugging:

#include <libsparklepaw/service.h>
#include <stdlib.h>
 
void main() {
  struct sprkl_service* service = malloc(sizeof(struct sprkl_service));
 
  sprkl_service_read(service, stdin);
  sprkl_service_printdebug(service, stderr);
 
  sprkl_service_freeall(service);
}

Example of making a request to a daemon via TCP transport:

#include <arpa/inet.h>
#include <errno.h>
#include <libsparklepaw/transport.h>
#include <netinet/in.h>
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <sys/socket.h>
 
int main(int argc, char** argv) {
  if (argc != 3) {
    fprintf(stderr, "usage: %s <inet4-addr> <tcp-port>\n", argv[0]);
    return 1;
  }
 
  // key for my example zone, replace it with one you can test against
  uint8_t key[0x20] = {
    0xc5, 0x82, 0x1e, 0x05, 0x34, 0x80, 0x17, 0x25,
    0x3c, 0xfc, 0x80, 0x87, 0x0b, 0xca, 0x03, 0xed,
    0x0a, 0x8b, 0x93, 0xbc, 0x33, 0x58, 0x33, 0x9e,
    0x7e, 0xee, 0x44, 0x08, 0xff, 0xfd, 0x2c, 0x2d
  };
 
  struct sprkl_request* req = sprkl_request_make_fetchservice(
    SPRKL_SIGALGO_ED25519, key, 0
  );
 
  // horrible awful code practices ensue. don't write your code like this, i
  // just did this cause it's shorter for the example :3
 
  struct sockaddr_in saddr;
  saddr.sin_family = AF_INET;
  saddr.sin_addr.s_addr = inet_addr(argv[1]);
  saddr.sin_port = htons(atoi(argv[2]));
  
  int sock = socket(AF_INET, SOCK_STREAM, 6);
  errno = 0;
  if (connect(sock, (struct sockaddr*) &saddr, sizeof saddr)) {
    fprintf(stderr, "connect error: %s\n", strerror(errno));
    return errno;
  }
  
  FILE* stream = fdopen(sock, "r+");
  struct sprkl_transport t = sprkl_transport_make_stream(stream);
 
  int err = sprkl_transport_sendrequest(&t, req);
  if (err) {
    fprintf(stderr, "req error: %s\n", sprkl_transport_strerror(&t, err));
    return err;
  }
 
  struct sprkl_response resp;
  resp.verb = req->verb;
  err = sprkl_transport_recvresponse(&t, &resp);
  if (err) {
    fprintf(stderr, "resp error: %s\n", sprkl_transport_strerror(&t, err));
    return err;
  }
 
  fclose(stream);
 
  fprintf(stderr, "response status code is %x\n", resp.status);
  if (resp.status != SPRKL_STATUS_OK) {
    fprintf(stderr, "server said: %*s\n", resp.errmsgsz, resp.errmsg);
  } else {
    sprkl_service_printdebug(resp.fetchsvc.svc, stdout);
  }
 
  sprkl_response_freeparts(&resp, true);
  sprkl_request_freeall(req);
}

As above, but using the system configured default transport:

#include <libsparklepaw/transport.h>
#include <stdio.h>
 
int main(int argc, char** argv) {
  // key for my example zone, replace it with one you can test against
  uint8_t key[0x20] = {
    0xc5, 0x82, 0x1e, 0x05, 0x34, 0x80, 0x17, 0x25,
    0x3c, 0xfc, 0x80, 0x87, 0x0b, 0xca, 0x03, 0xed,
    0x0a, 0x8b, 0x93, 0xbc, 0x33, 0x58, 0x33, 0x9e,
    0x7e, 0xee, 0x44, 0x08, 0xff, 0xfd, 0x2c, 0x2d
  };
 
  struct sprkl_request* req = sprkl_request_make_fetchservice(
    SPRKL_SIGALGO_ED25519, key, 0
  );
 
  struct sprkl_transport t;
  int err = sprkl_transport_make_default(&t);
  if (err == -1) {
    fprintf(stderr, "error: no default transport is available\n");
    return err;
  } else if (err) {
    fprintf(stderr, "make transport error: %s\n", sprkl_transport_strerror(&t, err));
    return err;
  }
 
  err = sprkl_transport_sendrequest(&t, req);
  if (err) {
    fprintf(stderr, "req error: %s\n", sprkl_transport_strerror(&t, err));
    return err;
  }
 
  struct sprkl_response resp;
  resp.verb = req->verb;
  err = sprkl_transport_recvresponse(&t, &resp);
  if (err) {
    fprintf(stderr, "resp error: %s\n", sprkl_transport_strerror(&t, err));
    return err;
  }
 
  sprkl_transport_fini_default(&t);
 
  fprintf(stderr, "response status code is %x\n", resp.status);
  if (resp.status != SPRKL_STATUS_OK) {
    fprintf(stderr, "server said: %*s\n", resp.errmsgsz, resp.errmsg);
  } else {
    sprkl_service_printdebug(resp.fetchsvc.svc, stdout);
  }
 
  sprkl_response_freeparts(&resp, true);
  sprkl_request_freeall(req);
}