Skip to content

Latest commit

 

History

History
149 lines (97 loc) · 3.29 KB

install.md

File metadata and controls

149 lines (97 loc) · 3.29 KB

Installation guide for "loda-rust"

Prerequisites

Computer with 64 bit cpu.

Step 1 - Install LODA-CPP

Follow the Install guide for LODA.

Verify that LODA-CPP really works

PROMPT> loda eval A40
2,3,5,7,11,13,17,19,23,29

Step 2 - Rust language

On macOS/Linux you may want to use your package manager.

Otherwise here is the Install guide for Rust.

Verify that Rust really works

PROMPT> cargo --version
cargo 1.63.0 (fd9c4297c 2022-07-01)

Step 3 - Ruby language (Only used for mining)

On macOS/Linux you may want to use your package manager.

Otherwise here is the Install guide for Ruby.

Verify that Ruby really works

PROMPT> ruby --version
ruby 3.0.2p107 (2021-07-07 revision 0db68f0233) [x86_64-darwin20]

Step 4 - Obtain "loda-rust" repository

Step 4 A

Check out the loda-rust repository on your computer.

A good place for this repository, is the $HOME/git/loda-rust dir.

Step 4 B

Compile the rust_project into an executable named loda-rust.

PROMPT> pwd
/Users/JOHNDOE/git/loda-rust/rust_project
PROMPT> cargo build --release
PROMPT> ./target/release/loda-rust
loda-rust 0.0.1
Experimental tool

USAGE:
    loda-rust <SUBCOMMAND>

OPTIONS:
    -h, --help       Print help information
    -V, --version    Print version information

SUBCOMMANDS:
    dependencies    Print all direct/indirect dependencies of a program
    evaluate        Evaluate a program
    help            Print this message or the help of the given subcommand(s)
    install         Create the $HOME/.loda-rust directory
    mine            Run the miner daemon process. Press CTRL-C to stop it.
    pattern         Identify recurring patterns among similar programs.
    similar         Identify similar programs.
PROMPT>

Step 4 C

On linux/macOS: Create symlink to the executable from within a bin dir, so loda-rust is available in $PATH.

PROMPT> cd ~/bin
PROMPT> ln -s ~/git/loda-rust/rust_project/target/release/loda-rust
PROMPT>

Check that loda-rust is still available, like this:

PROMPT> loda-rust

Step 4 D

PROMPT> loda-rust install

This creates a $HOME/.loda-rust dir.

Step 4 E

Manually edit the configuration file $HOME/.loda-rust/config.toml.

Here you must update the paths, so they refer to where LODA-CPP is installed on your computer.

Manually modify this parameter, so it points to the "loda-programs" repository dir.

loda_programs_repository = "/Users/JOHNDOE/loda/programs"

Manually modify this parameter, so it points to the LODA-RUST repository dir.

loda_rust_repository = "/Users/JOHNDOE/git/loda-rust"

Manually modify this parameter, so it points to the unzipped OEIS stripped file.

oeis_stripped_file = "/Users/JOHNDOE/loda/oeis/stripped"

Step 4 F

Verify that loda-rust can evaluate the program: A000040, The prime numbers.

PROMPT> loda-rust eval A40
2,3,5,7,11,13,17,19,23,29,31,37,41,43,47,53,59,61,67,71
PROMPT>

Step 4 Complete

Finally loda-rust is fully installed.

Usage

Mining (experimental)

See mining.md for getting started and usage.