Skip to content

aboubakr-jelloulat/readline-brew-installer

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

4 Commits
Β 
Β 
Β 
Β 

Repository files navigation

πŸ“š GNU Readline Brew Installer

Bash GNU Linux macOS Homebrew

A simple and clean Bash script to install and configure GNU readline library using Homebrew with proper environment variable setup.

Features

  • πŸ”§ Automated GNU readline installation via Homebrew
  • πŸ”— Automatic library linking with force flag
  • πŸ“ Dynamic path detection and configuration
  • 🌐 Environment variables setup (LDFLAGS, CPPFLAGS)
  • πŸ”„ Automatic shell configuration reload
  • πŸš€ One-command installation process

Quick Start

Prerequisites

  • macOS or Linux system
  • Homebrew installed
  • Bash shell

Installation

  1. Clone this repository:
git clone https://github.com/aboubakr-jelloulat/readline-brew-installer.git
cd readline-brew-installer
  1. Make the script executable:
chmod +x install_readline.sh
  1. Run the installation script:
./install_readline.sh

πŸ“‹ What the Script Does

  1. Installs readline using Homebrew
  2. Links the library with force flag to ensure proper linking
  3. Detects installation path automatically
  4. Sets environment variables for compilation
  5. Reloads shell configuration to apply changes immediately

πŸ”§ Manual Configuration

If you need to manually set the paths, update these environment variables in your shell configuration file (.zshrc, .bashrc, etc.):

export LDFLAGS="-L/path/to/readline/lib"
export CPPFLAGS="-I/path/to/readline/include"

πŸ› οΈ Troubleshooting

Common Issues

  • Permission denied: Make sure the script is executable (chmod +x install_readline.sh)
  • Homebrew not found: Install Homebrew first from brew.sh
  • Path issues: Verify your readline installation path with brew --prefix readline

Verify Installation

Check if readline is properly installed:

brew list | grep readline
pkg-config --libs readline

πŸ“ Project Structure

readline-brew-installer/
β”œβ”€β”€ README.md
β”œβ”€β”€ install_readline.sh
└── LICENSE

🀝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

  1. Fork the project
  2. Create your feature branch (git checkout -b feature/AmazingFeature)
  3. Commit your changes (git commit -m 'Add some AmazingFeature')
  4. Push to the branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

πŸ“„ License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

  • GNU Project for the readline library
  • Homebrew team for the package manager
  • Open source community

⭐ Star this repo if it helped you! ⭐

About

Simple Bash script to install and configure GNU readline library using Homebrew with proper environment setup

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages