Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/LvMalware/iperl
Run Perl interactively
https://github.com/LvMalware/iperl
interactive interpreter perl programming repl script
Last synced: about 1 month ago
JSON representation
Run Perl interactively
- Host: GitHub
- URL: https://github.com/LvMalware/iperl
- Owner: LvMalware
- License: gpl-3.0
- Created: 2020-06-14T14:31:07.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2022-04-10T15:49:03.000Z (over 2 years ago)
- Last Synced: 2024-08-16T16:22:32.876Z (5 months ago)
- Topics: interactive, interpreter, perl, programming, repl, script
- Language: Perl
- Homepage:
- Size: 828 KB
- Stars: 9
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# IPerl
> Interactive Perl interpreter
This is a simple REPL (Read, Execute, Print, Loop) script that aims to provide an easy and fun way to run an interactive Perl interpreter.
## Dependencies
- JSON
> user@pc:~$ cpan JSON
- Term::ReadKey
> user@pc:~$ cpan Term::ReadKey
## Installation
OS X & Linux:
```bash
git clone https://github.com/lvmalware/iperl && \
cd iperl && \
sudo ./install.sh
```
Windows:
Switch to Linux and try the method above :)
## Usage
## Some cool modules
Modules can be found [here](https://github.com/LvMalware/iperl_modules)
To install them:
1. clone the repository
```bash
git clone https://github.com/LvMalware/iperl_modules
```
2. add their path to the config file
Assuming you have a configuration file your $HOME directory, modify the value of 'path':
```JSON
{
"history" : "/home/lva/.iperl_history",
"prompt" : "IPerl",
"path" : ["/usr/share/iperl/modules", "add_your_path_here"]
}
```
## Writting and deploying your modules
Write a standart Perl module, like the following Example.pm:
```perl
package Example;
use base 'Exporter';
our @EXPORT = qw(test_func1 test_func2);
sub test_func1
{
...
}
sub test_func2
{
...
}
```
Copy your module to any location already on the path (configured on your config file) or add its location to the path as shown above.
## use vs. loadModule
The release 1.1.1 introduced the loadModule() function that can be used (as the name sugests) to load the contents of a module into the current running instance of IPerl.
loadModule() can be used only inside the interactive interpreter and does basically the same as 'use', but with the difference that it will automatically add all the exported names from the loaded module to the completion list, allowing these names to be sugested and completed by typing their first letters and pressing tab.
Besides that, there is no advantage in using loadModule() instead of 'use' to load modules.
## Latest updates
### Version 1.2.1
- Fixed issues with IPerl::Term
### Version 1.2
- Added syntax highlight
- Removed dependence on Term::ReadLine::Gnu (replaced by IPerl::Term)
- Added key-binding capabilities
### Version 1.1.1
- Added support for config file in JSON format
- Added a loadModule() function. Modules loaded through loadModule() have their exported names automatically added to the completion list
- Default modules can be specified through the config file
### Version 1.1
- Added an install.sh for easy installation within unix-like systems
- Moved execution context away from IPerl's code scope to avoid conflicts
- Added support for custom modules (need to be expanded ...)
## TODO list
- Add more custom modules
- Allow editing multi-line code
- Improve multi-line code support
- Fix any bugs that may appear within IPerl::Term
## Meta
Lucas V. Araujo – [email protected]
Distributed under the GNU GPL-3.0+ license. See ``LICENSE`` for more information.
[https://github.com/LvMalware/iperl](https://github.com/LvMalware/)
## Contributing
1. Fork it ()
2. Create your feature branch (`git checkout -b feature/fooBar`)
3. Commit your changes (`git commit -am 'Add some fooBar'`)
4. Push to the branch (`git push origin feature/fooBar`)
5. Create a new Pull Request