Outscale Brew Formulas

---

🌐 Links

• Documentation: https://docs.outscale.com/en/
• Tap URL: outscale/tap
• Community: Join us on Discord

---

📄 Table of Contents

• Overview
• Requirements
• Installation
• Usage
• Maintainers: Updating Python Formulae
• Contributing
• License

---

🧭 Overview

Outscale Brew Formulas is the official Homebrew tap for Outscale tools and utilities. It lets you install Outscale software via brew on macOS and Linux.

Highlights

• Simple installation with brew tap outscale/tap
• Reproducible builds with vendored Python resources
• Central place to discover Outscale CLI tools

---

✅ Requirements

• macOS or Linux
• Homebrew installed and in your PATH
• (Optional) Developer tools for building from source

---

⚙ Installation

brew tap outscale/tap

You can then install any formula from this tap, for example:

brew install outscale/tap/<formula-name>
# e.g.
# brew install outscale/tap/oapi-cli

---

🚀 Usage

List available formulas from the tap:

brew search outscale/tap/

Upgrade installed formulas:

brew upgrade outscale/tap/<formula-name>

Reinstall from source (useful while developing a formula):

brew reinstall --build-from-source ./<formula-file>.rb

---

🔧 Maintainers: Updating Python Formulae

When a packaged Python project releases a new version, update the corresponding formula:

1. Get the new version and file URL on PyPI

   • Go to the project’s page on PyPI (e.g., https://pypi.org/project/<pkg>/<version>/#files)
   • Copy the source tarball URL and its SHA256.

2. Edit the formula

   • Update the url and sha256 fields in ./<formula>.rb to match the new PyPI release.

3. Refresh vendored resources

   • From the repository root, run:

     brew update-python-resources ./oapi-cli.rb

     Replace oapi-cli.rb with the formula you’re maintaining.

4. Test locally

   brew reinstall --build-from-source ./oapi-cli.rb
   brew audit --new --strict ./oapi-cli.rb
   brew test ./oapi-cli.rb

5. Open a PR

   • Include a short changelog and the upstream release link.

---

📜 License

Outscale Brew Formulas is released under the BSD-3-Clause license.

© 2025 Outscale SAS

See LICENSE for full details.

---

🤝 Contributing

We welcome contributions!

Please read our Contributing Guidelines and Code of Conduct before submitting a pull request.