Neptuno is an "environment as code" framework; which aims to be opinionated enough to get you going fast, and customizable enough to run just the way you work.

Add this line to your application's Gemfile:

gem 'neptuno'

And then execute:

$ bundle install

Or install it yourself as:

$ gem install neptuno

Once installed you can run neptuno by its executable to see the options available.

$ bundle exec neptuno

If you are using a version manager for Ruby you may want to setup an alias to the executable shim so that you can run Neptuno even when your manager switches ruby versions. Notice that you may have to change the path depending on which Ruby version you use globally:

Add this to your ~/.zshrc

alias uno='/Users/$USER/.rvm/gems/ruby-3.0.2/bin/neptuno'

Add this to your ~/.zshrc

alias uno='/Users/$USER/.asdf/installs/ruby/3.0.2/bin/neptuno'

Add this to your neptuno.yml

docker_delimiter: "_"

The path you need for rbenv and asdf may be different.

After checking out the repo, run bin/setup to install dependencies. Then, run rake test to run the tests. You can also run bin/console for an interactive prompt that will allow you to experiment.

To install this gem onto your local machine, run bundle exec rake install. To release a new version, update the version number in version.rb, and then run bundle exec rake release, which will create a git tag for the version, push git commits and the created tag, and push the .gem file to rubygems.org.

Bug reports and pull requests are welcome on GitHub at https://github.com/apptegy/neptuno. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the code of conduct.

The gem is available as open source under the terms of the Apache 2.0.

Everyone interacting in the Neptuno project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the code of conduct.