Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/spaceship-prompt/spaceship-maven

๐‘š Maven section for Spaceship prompt
https://github.com/spaceship-prompt/spaceship-maven

java maven prompt shell spaceship spaceship-prompt terminal zsh

Last synced: 1 day ago
JSON representation

๐‘š Maven section for Spaceship prompt

Awesome Lists containing this project

README

        


๐‘š + ๐Ÿš€

Spaceship Maven


Maven section for Spaceship prompt



GitHub Release


GitHub Workflow Status


Spaceship Twitter


Chat on Discord

Current Maven version, through `mvn` or `mvnw` (`๐‘š`).

## Installing

You need to source this plugin somewhere in your dotfiles. Here's how to do it with some popular tools:

### [Oh-My-Zsh]

Execute this command to clone this repo into Oh-My-Zsh plugin's folder:

```zsh
git clone https://github.com/spaceship-prompt/spaceship-maven.git $ZSH_CUSTOM/plugins/spaceship-maven
```

Include `spaceship-maven` in Oh-My-Zsh plugins list:

```zsh
plugins=($plugins spaceship-maven)
```

### [zplug]

```zsh
zplug "spaceship-prompt/spaceship-maven"
```

### [antigen]

```zsh
antigen bundle "spaceship-prompt/spaceship-maven"
```

### [antibody]

```zsh
antibody bundle "spaceship-prompt/spaceship-maven"
```

### [zinit]

```zsh
zinit light "spaceship-prompt/spaceship-maven"
```

### [zgen]

```zsh
zgen load "spaceship-prompt/spaceship-maven"
```

### [sheldon]

```toml
[plugins.spaceship-maven]
github = "spaceship-prompt/spaceship-maven"
```

### Manual

If none of the above methods works for you, you can install Spaceship manually.

1. Clone this repo somewhere, for example to `$HOME/.zsh/spaceship-maven`.
2. Source this section in your `~/.zshrc`.

### Example

```zsh
mkdir -p "$HOME/.zsh"
git clone --depth=1 https://github.com/spaceship-prompt/spaceship-maven.git "$HOME/.zsh/spaceship-maven"
```

For initializing prompt system add this to your `.zshrc`:

```zsh title=".zshrc"
source "~/.zsh/spaceship-section/spaceship-maven.plugin.zsh"
```

## Usage

After installing, add the following line to your `.zshrc` in order to include Maven section in the prompt:

```zsh
spaceship add maven
```

## Options

Shows current maven version only if current working directory is within Maven wrapper or `mvn` exists available.

| Variable | Default | Meaning |
| :------------------------------------ | :--------------------------------: | ---------------------------------------------- |
| `SPACESHIP_MAVEN_SHOW` | `true` | Current Maven section |
| `SPACESHIP_MAVEN_PREFIX` | `$SPACESHIP_PROMPT_DEFAULT_PREFIX` | Prefix before Maven section |
| `SPACESHIP_MAVEN_SUFFIX` | `$SPACESHIP_PROMPT_DEFAULT_SUFFIX` | Suffix after Maven section |
| `SPACESHIP_MAVEN_SYMBOL` | `๐‘šยท` | Character to be shown before Maven section |
| `SPACESHIP_MAVEN_DEFAULT_VERSION` | ` ` | Maven version to be treated as default |
| `SPACESHIP_MAVEN_COLOR` | `yellow` | Color of Maven section |

## Contributing

First, thanks for your interest in contributing!

Contribute to this repo by submitting a pull request. Please use [conventional commits](https://www.conventionalcommits.org/), since this project adheres to [semver](https://semver.org/) and is automatically released via [semantic-release](https://github.com/semantic-release/semantic-release).

## License

MIT ยฉ [Denys Dovhan](http://yourwebsite.com) and Sergey Shatunov

[Oh-My-Zsh]: https://ohmyz.sh/
[zplug]: https://github.com/zplug/zplug
[antigen]: https://antigen.sharats.me/
[antibody]: https://getantibody.github.io/
[zinit]: https://github.com/zdharma/zinit
[zgen]: https://github.com/tarjoilija/zgen
[sheldon]: https://sheldon.cli.rs/