fork of radicle with Git LFS support, backed by IPFS
Go to file
Fintan Halpenny f11991737f
remote-helper: allow fetching from canonical refs
There is no mechanism for fetching the canonical `refs/heads/master`
from a project's repository into a local working copy.

Allow setting up a remote in the working copy, e.g.

    [remote "canon"]
	url = rad://z3gqcJUoA1n9HaHKufZs5FCSGazv5
	fetch = +refs/heads/master:refs/remotes/canon/master

Such that it can fetch the `master` branch, but disallows push to the
canonical reference namespace.

This is achieved by allowing the namespace in `radicle::git::Url` to
be `None` when the radicle-remote-helper is called. It disallows the
namespace to be None during a `git-receive-pack` -- also keeping the
check for the namespace being equal to the local operator's key.

When the namespace is `None` then `GIT_NAMESPACE` is set to the empty
string.

Signed-off-by: Fintan Halpenny <fintan.halpenny@gmail.com>
X-Clacks-Overhead: GNU Terry Pratchett
2023-04-20 16:34:02 +02:00
.github/workflows ci: Remove `ci.yaml` 2023-04-17 15:58:55 +02:00
.nix Rust 1.67 2023-02-04 19:30:29 +01:00
radicle cli: reduce `rad ls` dependency 2023-04-19 12:50:07 +02:00
radicle-cli cli: add verbose flag to rad ls 2023-04-20 16:31:05 +02:00
radicle-cli-test cli-test: Improve testing framework logging 2023-03-13 11:38:33 +01:00
radicle-cob cob: Deduplicate change parents 2023-04-14 13:54:27 +02:00
radicle-crdt Update `fastrand` dependency to 1.9.0 2023-04-14 13:15:52 +02:00
radicle-crypto crypto: add PublicKey::to_namespace 2023-03-30 15:53:27 +01:00
radicle-dag Update `fastrand` dependency to 1.9.0 2023-04-14 13:15:52 +02:00
radicle-httpd cob: Deduplicate change parents 2023-04-14 13:54:27 +02:00
radicle-node node: Fix log output in `--help` 2023-04-20 16:32:41 +02:00
radicle-remote-helper remote-helper: allow fetching from canonical refs 2023-04-20 16:34:02 +02:00
radicle-ssh Update to Rust 1.65 2022-11-05 12:47:26 +01:00
radicle-term cli: Unify format of help messages 2023-04-10 10:06:45 +02:00
radicle-tools tools: Add tool to set canonical refs 2023-04-17 22:10:20 +02:00
radicle-tui tui: Move shortcuts to root widget 2023-04-19 10:40:05 +02:00
scripts scripts: Add `delete-remote-refs.sh` 2023-04-15 00:15:02 +02:00
.dockerignore Dockerize services 2022-12-14 17:15:40 +01:00
.env.seed seed: Update default tracking policy for seed 2023-04-17 21:16:56 +02:00
.gitignore Initial commit 2022-09-13 10:13:13 +02:00
.gitsigners Add `.gitsigners` file with core team 2023-04-05 11:46:57 +02:00
ARCHITECTURE.md Flesh out `HACKING.md` 2023-03-16 13:06:38 +01:00
CONTRIBUTING.md Flesh out `CONTRIBUTING.md` 2023-03-13 15:10:53 +01:00
Cargo.lock tui: Add ui wrapper for patches 2023-04-18 16:21:54 +02:00
Cargo.toml tui: Add basic framework 2023-03-20 16:27:42 +01:00
DCO Add licenses and contributor information 2022-11-16 12:26:12 +01:00
HACKING.md node: Rename control socket 2023-03-31 17:29:58 +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 Flesh out `README` 2023-03-13 12:19:20 +01:00
build.rs Rust 1.67 2023-02-04 19:30:29 +01:00
docker-compose.yml ci: Add git tracing to node deployment 2023-03-16 12:30:15 +01:00
rust-toolchain Rust 1.67 2023-02-04 19:30:29 +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 implemention 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.

Installation

Requirements

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

📦 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
cargo install --path radicle-node --force --locked
cargo install --path radicle-remote-helper --force --locked

Or directly from our seed node:

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

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.