fork of radicle with Git LFS support, backed by IPFS
Go to file
Fintan Halpenny 72c715016f
fetch: add trace logging to fetch protocol
Log the following at the trace level:
- Receiving the pack along with the amount of time it took
- The closing of the connection

Also organising the imports, while in the neighbourhood.

Signed-off-by: Fintan Halpenny <fintan.halpenny@gmail.com>
X-Clacks-Overhead: GNU Terry Pratchett
2024-05-15 10:07:56 +01:00
.config nix: switch to use nix flakes 2023-12-13 12:25:12 +01:00
.radicle build: add config for Radicle native CI engine 2024-01-19 11:29:23 +01:00
build build: Push tags as part of upload 2024-05-02 21:37:15 +02:00
debian Add rudimentary Debian packaging for binaries 2023-11-01 12:56:35 +01:00
radicle node: stream timeout semantics for `Node::call` 2024-05-15 10:07:56 +01:00
radicle-cli cli: watch for upload-pack events in `rad init` 2024-05-15 10:07:56 +01:00
radicle-cli-test Update radicle crates to 0.9.0 2024-03-26 11:56:27 +01:00
radicle-cob Tidy up environment variables 2024-04-26 10:38:54 +02:00
radicle-crdt Introduce `cargo-deny` 2023-08-22 14:33:00 +02:00
radicle-crypto node: Patch dependencies for Tor/socks5 support 2024-05-06 22:19:36 +02:00
radicle-dag Update radicle crates to 0.9.0 2024-03-26 11:56:27 +01:00
radicle-fetch fetch: add trace logging to fetch protocol 2024-05-15 10:07:56 +01:00
radicle-httpd node: Allow for "WAL" mode in sqlite 2024-05-14 16:34:30 +02:00
radicle-node node: increase `FETCH_TIMEOUT` 2024-05-15 10:07:56 +01:00
radicle-remote-helper Tidy up environment variables 2024-04-26 10:38:54 +02:00
radicle-signals signals: Move signal handling to its own crate 2024-05-03 14:30:51 +02:00
radicle-ssh Update radicle crates to 0.9.0 2024-03-26 11:56:27 +01:00
radicle-term cli: Use new pager for `rad diff` 2024-05-03 14:31:08 +02:00
radicle-tools term: Implement content-aware pager 2024-05-03 14:31:05 +02:00
scripts scripts: Script for outputting markdown changelog 2024-05-02 17:00:14 +02:00
systemd systemd: Update for system install 2024-02-08 12:34:26 +01:00
.dockerignore build: Add "upload" build step 2024-04-29 10:47:03 +02:00
.env.seed seed: Update default tracking policy for seed 2023-04-17 21:16:56 +02:00
.envrc nix: simplify devShell and envrc 2023-12-14 10:52:04 +01:00
.gitignore Reproducible cross-compiled builds 2024-04-20 11:11:00 +02:00
.gitsigners Add yorgos to .gitsigners 2023-08-18 16:36:02 +02:00
ARCHITECTURE.md docs: link to protocol guide 2024-04-03 15:32:26 +02:00
CONTRIBUTING.md docs: Typo fixes 2024-04-29 13:28:31 +02:00
Cargo.lock node: report upload-pack progress 2024-05-15 10:07:56 +01:00
Cargo.toml signals: Move signal handling to its own crate 2024-05-03 14:30:51 +02:00
DCO Add licenses and contributor information 2022-11-16 12:26:12 +01:00
HACKING.md docs: Typo fixes 2024-04-29 13:28:31 +02:00
LICENSE-APACHE Add licenses and contributor information 2022-11-16 12:26:12 +01:00
LICENSE-MIT Add licenses and contributor information 2022-11-16 12:26:12 +01:00
README.md docs: Fix download link in README.md 2024-05-04 22:58:39 +02:00
VERSIONING.md build: Add "upload" build step 2024-04-29 10:47:03 +02:00
build.rs Reproducible cross-compiled builds 2024-04-20 11:11:00 +02:00
deny.toml Introduce `cargo-deny` 2023-08-22 14:33:00 +02:00
docker-compose.yml docker: Add `$USER` env var to docker-compose 2023-07-26 12:35:55 +02:00
flake.lock nix: Update rust-overlay input to rust 1.77 2024-03-30 22:58:21 +01:00
flake.nix man: Add `rad-id.1` man page 2024-03-17 21:14:58 +01:00
git-remote-rad.1.adoc Add rudimentary Debian packaging for binaries 2023-11-01 12:56:35 +01:00
rad-id.1.adoc cli: Have way to delete payload field in `rad id` 2024-05-13 16:12:41 +02:00
rad-patch.1.adoc docs: Update manual pages to 1.0.0 2024-04-22 14:37:19 +02:00
rad.1.adoc docs: Update manual pages to 1.0.0 2024-04-22 14:37:19 +02:00
radicle-httpd.1.adoc docs: Update manual pages to 1.0.0 2024-04-22 14:37:19 +02:00
radicle-node.1.adoc docs: Update manual pages to 1.0.0 2024-04-22 14:37:19 +02:00
rust-toolchain Update toolchain to Rust 1.77 2024-03-26 10:03:11 +01:00

README.md

❤️🪵

Radicle Heartwood Protocol & Stack

Heartwood is the third iteration of the Radicle Protocol, a powerful peer-to-peer code collaboration and publishing stack. The repository contains a full implementation of Heartwood, complete with a user-friendly command-line interface (rad) and network daemon (radicle-node).

Radicle was designed to be a secure, decentralized and powerful alternative to code forges such as GitHub and GitLab that preserves user sovereignty and freedom.

See the Protocol Guide for an in-depth description of how Radicle works.

Installation

Requirements

  • Linux or Unix based operating system.
  • Git 2.34 or later
  • OpenSSH 9.1 or later with ssh-agent

📀 From binaries

Requires curl and tar.

Run the following command to install the latest binary release:

curl -sSf https://radicle.xyz/install | sh

Or visit our download page.

📦 From source

Requires the Rust toolchain.

You can install the Radicle stack from source, by running the following commands from inside this repository:

cargo install --path radicle-cli --force --locked --root ~/.radicle
cargo install --path radicle-node --force --locked --root ~/.radicle
cargo install --path radicle-remote-helper --force --locked --root ~/.radicle

Or directly from our seed node:

cargo install --force --locked --root ~/.radicle \
    --git https://seed.radicle.xyz/z3gqcJUoA1n9HaHKufZs5FCSGazv5.git \
    radicle-cli radicle-node radicle-remote-helper

Running

Systemd unit files are provided for the node and HTTP daemon under the /systemd folder. They can be used as a starting point for further customization.

For running in debug mode, see HACKING.md.

Contributing

See CONTRIBUTING.md and HACKING.md for an introduction to contributing to Radicle.

License

Radicle is distributed under the terms of both the MIT license and the Apache License (Version 2.0).

See LICENSE-APACHE and LICENSE-MIT for details.