Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/zpl-c/track
Native C99 event tracking library.
https://github.com/zpl-c/track
c c99 cpp curl desktop iot library mobile native segment
Last synced: 24 days ago
JSON representation
Native C99 event tracking library.
- Host: GitHub
- URL: https://github.com/zpl-c/track
- Owner: zpl-c
- License: other
- Created: 2021-06-26T12:14:52.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2023-06-17T13:15:39.000Z (over 1 year ago)
- Last Synced: 2024-09-30T01:22:53.993Z (about 1 month ago)
- Topics: c, c99, cpp, curl, desktop, iot, library, mobile, native, segment
- Language: C
- Homepage:
- Size: 404 KB
- Stars: 1
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG
- Contributing: .github/CONTRIBUTING.md
- License: LICENSE
- Security: .github/SECURITY.md
Awesome Lists containing this project
README
Event tracking library.
# Introduction
zpl.track is a cross-platform event tracker that can send your event data to a UDP echo server. You can then pipe the telemetry data to any destinations desired. It aims to be very minimalist and easy to integrate.
# How to obtain this library?
There are several options in getting hands-on this library:
## 1. Via CLI (the simplest option)
```sh
curl -L https://github.com/zpl-c/track/releases/latest/download/track.h > track.h
# OR
wget https://github.com/zpl-c/track/releases/latest/download/track.h -O track.h
```
This approach will download the latest release of zpl.track with everything prepared for you.
## 2. Via GitHub releases page
* Navigate to the [releases page](https://github.com/zpl-c/track/releases) of the zpl.track repository and pick the version you want to use. Each release contains the distributed version of zpl.track for you to use easily.
## 3. Cloning the repository
* Clone the repository by pressing the **Clone or download** button for instructions or use your terminal to clone:
```sh
git clone https://github.com/zpl-c/track.git
```
We use this method to develop zpl.track as it contains all the development sources that are easy to modify and expand, but it is not suitable for use in production.
Please follow the [CONTRIBUTING.md](.github/CONTRIBUTING.md) guide to learn how to contribute to the project.
## Build the demo
We use CMake to generate project files.
You can do the following on the command line to create and build this project:
```sh
cmake -S misc -B build
cmake --build build
```
Run `build/echo` first, then run the compiled `build/demo`.
## NodeJS event receiver companion
We offer a simple to use NodeJS library to receive telemetry data from zpl.track. You can check it out on [npm registry](https://www.npmjs.com/package/zpl.track) or by installing the package locally using:
```sh
npm install --save zpl.track
# OR
yarn install zpl.track
```
## Example code
```c
#define TRACK_IMPL
#include
#include // for rand, srand
#include // for time
#include // for printf, snprintf
int err = 0;
#define CHECK(code)\
err = code;\
if (err) {\
printf("error code: %d\n", err);\
track_destroy();\
return err;\
}
int main() {
srand(time(NULL)*time(NULL));
CHECK(track_init("127.0.0.1", "8200"));
char userId[13] = {0};
snprintf(userId, 13, "id-%d", rand()%99999);
CHECK(track_ident(userId, "{\"demoId\": 42, \"name\": \"Jane Doe\"}"));
CHECK(track_event("demo_app opened", userId, "{\"foo\": 123, \"open_timestamp\": 123893893}"));
CHECK(track_event("demo_app action", userId, "{\"foo\": \"bar\"}"));
CHECK(track_group(userId, "abc", "{\"demoId\": 42, \"name\": \"Jane Doe\"}"));
track_prop props[] = {
{"mode", "\"demo\""},
{"speed", "\"fast\""},
{"contains_bugs", "false"},
{0}
};
CHECK(track_event_props("demo_app submitted", userId, props));
CHECK(track_destroy());
return 0;
}
```
## Looking for the old Segment.IO version?
We discontinued the outdated library due to its complexity and reliance on cURL and CMake. We made modifications and streamlined the API for simplicity and performance. The old version can still be accessed [here](https://github.com/zpl-c/track/tree/v1), but we don't provide support for it.
## License
See [LICENSE](LICENSE) for the license.