https://github.com/truemedian/zfetch

https://github.com/truemedian/zfetch

http zig

Last synced: 3 months ago
JSON representation

• Host: GitHub
• URL: https://github.com/truemedian/zfetch
• Owner: truemedian
• License: mit
• Archived: true
• Created: 2020-12-29T00:33:51.000Z (almost 4 years ago)
• Default Branch: master
• Last Pushed: 2022-09-16T23:52:50.000Z (about 2 years ago)
• Last Synced: 2024-05-03T12:12:09.017Z (6 months ago)
• Topics: http, zig
• Language: Zig
• Homepage:
• Size: 97.7 KB
• Stars: 59
• Watchers: 1
• Forks: 8
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
## Notice

This package is deprecated and archived for the foreseeable future due to the zig master being an ever changing target

and my lack of time to address and fix things that have changed. Those looking for a similar experience should look

at [haze/zelda](https://github.com/haze/zelda).

# zfetch

[![Linux Workflow Status](https://img.shields.io/github/workflow/status/truemedian/zfetch/Linux?label=Linux&style=for-the-badge)](https://github.com/truemedian/zfetch/actions/workflows/linux.yml)

[![Windows Workflow Status](https://img.shields.io/github/workflow/status/truemedian/zfetch/Windows?label=Windows&style=for-the-badge)](https://github.com/truemedian/zfetch/actions/workflows/windows.yml)

[![MacOS Workflow Status](https://img.shields.io/github/workflow/status/truemedian/zfetch/MacOS?label=MacOS&style=for-the-badge)](https://github.com/truemedian/zfetch/actions/workflows/macos.yml)

A HTTP request library for Zig with HTTPS support.

## Features

* HTTPS support, including trust handling (provided by [iguanaTLS](https://github.com/alexnask/iguanaTLS))

* A relatively simple interface.

## Notes

* Passing `null` as the `trust_chain` in Request.init will tell zfetch to **not check server certificates**. If you do

  not trust your connection, please provide a iguanaTLS x509 certificate chain.

* zfetch only does rudimentary checks to ensure functions are called in the right order. These are nowhere near enough

  to prevent you from doing so, please call the functions in the order they are intended to be called in.

## Adding zfetch as a package

### Gyro

```zzz

# gyro.zzz

...

deps:

  truemedian/zfetch: ^0.1.1

...

```

### Zigmod

```yaml

# zig.mod

...

dependencies:

  - type: git

    path: https://github.com/truemedian/zfetch

...

```

### Submodules

> Assuming zfetch is **recursively** checked out at `libs/zfetch`

```zig

// build.zig

const zfetch = @import("libs/zfetch/build.zig");

...

exe.addPackage(zfetch.getPackage(b, "libs/zfetch"));

...

```

## Examples

see [examples](https://github.com/truemedian/zfetch/tree/master/examples).

**More Coming Soon...?**