Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Include "an idiots guide to installing flac-tracksplit" in README #39

Open
TheLinuxGuy opened this issue Sep 16, 2023 · 1 comment
Open

Comments

@TheLinuxGuy
Copy link

TheLinuxGuy commented Sep 16, 2023

Can you please include some setup instructions?

I have a Windows machine and installed https://doc.rust-lang.org/cargo/getting-started/installation.html then attempted to install using the command listed in: https://crates.io/crates/flac-tracksplit

It failed

flac-tracksplit>cargo add flac-tracksplit
warning: some crates are on edition 2021 which defaults to `resolver = "2"`, but virtual workspaces default to `resolver = "1"`
note: to keep the current resolver, specify `workspace.resolver = "1"` in the workspace root's manifest
note: to use the edition 2021 resolver, specify `workspace.resolver = "2"` in the workspace root's manifest
      Adding flac-tracksplit (local) to dependencies.
error: cannot add `flac-tracksplit` as a dependency to itself

I'm unfamiliar with Rust, but familiar with GoLang - maybe you could include "precompiled" binaries in your project for easy download? Right now it seems that I have to build the binaries myself, and being a person without rust experience I don't know where to begin. Sorta expected "releases" to have downloads but none exist for this project.

edit: I guess this tool may not be meant to work (or tested on windows)

C:\Users\Giovanni\split>flac-tracksplit.exe --output-dir C:\Users\Giovanni\split\out C:\Users\Giovanni\split\*.flac
2023-09-16T23:46:27.681473Z ERROR split_one_file: error=opening "C:\\Users\\Giovanni\\split\\*.flac" input_path="C:\\Users\\Giovanni\\split\\*.flac"
2023-09-16T23:46:27.682040Z ERROR error=splitting "C:\\Users\\Giovanni\\split\\*.flac"
Error: splitting "C:\\Users\\Giovanni\\split\\*.flac"

Caused by:
    0: opening "C:\\Users\\Giovanni\\split\\*.flac"
    1: The filename, directory name, or volume label syntax is incorrect. (os error 123)
@antifuchs
Copy link
Collaborator

Ouch, sorry, I did include a "how to install" guide in some of my less recently released projects but not in this one. I'll leave this issue open as a reminder to update the readme, but to unblock you, it's this command line (assuming you have current rust stable from rustup):

cargo install --git https://github.com/boinkor-net/flac-tracksplit.git flac-tracksplit

Your intuition to use cargo add isn't a bad one (it does "add" a thing to a cargo workspace!), but unfortunately runs afoul of the mixed UX metaphors in play when using cargo: It exists to manage a global rust setup (to a small part) as well as deal with a rust code workspace (for the most part). Only the "install" verb works on the global rust setup, installing crates that "are" binaries. The "add" verb would add a library crate reference to a Cargo.toml (similar to go mod tidy after you reference a package in a source file).

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

2 participants