corral

by ponylang

ponylang / corral

:horse: Pony dependency manager tool

144 Stars 15 Forks Last release: 2 months ago (0.4.0) BSD 2-Clause "Simplified" License 161 Commits 9 Releases

Available items

No Items, yet!

The developer of this repository has not created any items for sale yet. Need a bug fixed? Help with integration? A different license? Create a request here:

Corral

Pony dependency manager

Status

Actions Status

Corral is beta level software.

About Corral

Corral is a dependency management tool for Pony. Corral:

  • Provides extensibility for VCS and Commands.
  • Supports semver version constraints on dependencies.
  • Supports transitive dependencies.
  • Supports revision locking on dependencies using a lock.json file.
  • Uses a distinct shared VCS repo pool from per-project dependency workspace tree.
  • Uses the Pony process package for running external tools like Git and ponyc.

Design

See Corral Design for more details about the design of Corral. Ongoing questions and notes for future work can be found in Questions / Notes

Background

Check out Pony Package Dependency Management for a discussion of the research and requirements work behind Corral.

Installation

Use ponyup to install corral.

The following command is assuming that

ponyup
, our toolchain multiplexer, is already installed on your machine and is available in your $PATH environment variable. If you don't have ponyup installed, please follow the ponyup installation instructions.
ponyup update corral release

Building From Source

See BUILD.md

Getting started using Corral

After installation, add Corral's current path to $PATH environment variable if you haven't already and follow these steps to create your first project using Corral.

Create a project

Make an empty folder and switch to this directory. This will be our example project to use Corral

mkdir myproject
cd myproject

Initialize Corral

It will create

corral.json
and
lock.json
files. At this moment they won't have much information since you haven't added any dependencies yet.
corral init

Add a dependency

This is the way to tell Corral that your project depends on this and you want to include it when building your project.

corral add github.com/ponylang/valbytes.git

Use a dependency

Create a file

main.pony
with following code.
use "valbytes"

actor Main new create(env: Env) => var buf: ByteArrays = ByteArrays buf = buf + "!!" + "Hello," + " " + "World!" let greetings = buf.drop(2).string() env.out.print(greetings)

Fetch dependencies

The example Pony code is using

ByteArrays
type which is defined in the dependency which you have just added. Pony needs to have the source code of
ByteArrays
type to compile successfully. By fetching, Corral retrieves the source and makes it available when compiling the source code
corral fetch

Build the project

Corral will now use this information to build the project. The command below act as a wrapper for

ponyc
corral run -- ponyc

If there are no errors generated then an executable

myproject
will be created in the same folder.

You will also notice that there are two new folders

_corral
and
_repos
in your project folder now. They were generated by the
corral fetch
command. Please make sure to include them in your
.gitignore
file as there is no need to keep them in a versioning system since they are maintained by Corral itself.

Documentation

See DOCS.md

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.