grnenv-rs 0.1.2

grnenv is a tool to switch using multiple Groonga versions.
Documentation

grnenv-rs

Build Status Build status

grnenv-rs is a tool to switch using multiple Groonga versions.

Currently, only confirmed to work on Windows 10, macOS Sierra(10.12), and Ubuntu Trusty (14.04 LTS).

Prerequisites

Windows + just download executables

  • Visual C++ Redistributable for Visual Studio 2015

x86_64 msvc target binaries are found at: https://github.com/cosmo0920/grnenv-rs/releases

And then, put binaries into $Env:USERPROFILE\bin.

Windows + build yourself

And follow the descriptions:

https://github.com/sfackler/rust-openssl#windows

*nix via cargo install

Prepare the following dependent libraries:

  • C and C++ compilers like gcc or clang
  • autoconf
  • automake
  • libtool
  • pkg-config
  • pcre
  • openssl development package (libssl-dev or openssl-devel like package)
  • rust compiler (installed with rustup)

And then,

$ cargo install grnenv-rs

For macOS via cargo install

You can use homebrewed openssl for compiling openssl-sys crate like this:

export OPENSSL_INCLUDE_DIR=`brew --prefix openssl`/include
export OPENSSL_LIB_DIR=`brew --prefix openssl`/lib

And then,

$ cargo install grnenv-rs

Note

If you installed openssl library in non-standard place, please specify OPENSSL_PKG_CONFIG_PATH environment variable like this:

$ export OPENSSL_PKG_CONFIG_PATH=/path/to/installed/openssl/lib/pkgconfig

Plugin system

This tool has plugin system, which is using subcommand mechanism.

You should put grnenv-* executables into $PATH or ~/bin.

Notes

In Windows, grnenv-* subcommand should be portable executables. If you want to support Windows in subcommand, it recommends to use Rust language and build (i686|x86_64)-pc-windows-msvc target.

Usage

For Windows

git clone and,

PS> cargo install
PS> grnenv init

And then, Please create profile.ps1 the following place:

$Env:USERPROFILE\Documents\WindowsPowerShell\profile.ps1

And write the following thing:

. $Env:USERPROFILE\.groonga\shims\bin\source-groonga.ps1

then,

PS> grnenv install VERSION [--arch (x86|x64)]
PS> grnenv switch VERSION [--arch (x86|x64)]

Finally, restart powershell and use specified version of Groonga.

If you get an error, you should specify execution policy as follows:

PS> Set-ExecutionPolicy RemoteSigned

For *nix environment

git clone and,

$ cargo install
$ grnenv init

And write the following into .bash_profile or .zsh_profile etc.:

. $HOME/.groonga/shims/bin/source-groonga.sh

then,

$ grnenv install VERSION
$ grnenv switch VERSION

Finally, restart your shell and use specified version of Groonga.

LICENSE

MIT.

Related Articles