Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/wilsonsilva/tuga
A Portuguese script programming language meant for educational purposes.
https://github.com/wilsonsilva/tuga
portugal portuguese ruby ruby-gem script scripting-language tuga
Last synced: 3 months ago
JSON representation
A Portuguese script programming language meant for educational purposes.
- Host: GitHub
- URL: https://github.com/wilsonsilva/tuga
- Owner: wilsonsilva
- License: mit
- Created: 2020-06-06T09:24:46.000Z (over 4 years ago)
- Default Branch: main
- Last Pushed: 2023-08-31T09:19:27.000Z (over 1 year ago)
- Last Synced: 2024-08-09T10:54:19.309Z (6 months ago)
- Topics: portugal, portuguese, ruby, ruby-gem, script, scripting-language, tuga
- Language: Ruby
- Homepage:
- Size: 113 KB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE.txt
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
# Tuga
[](https://badge.fury.io/rb/tuga)
[](https://github.com/wilsonsilva/tuga/actions/workflows/main.yml)
[](https://codeclimate.com/github/wilsonsilva/tuga/maintainability)
[](https://codeclimate.com/github/wilsonsilva/tuga/test_coverage)
[](http://inch-ci.org/github/wilsonsilva/tuga)
A Portuguese script programming language meant for educational purposes.
## Requirements
The gem requires version 3.2 of the Ruby programming language.
## Installation
Add this line to your application's Gemfile:
```ruby
gem 'tuga'
```
And then execute:
$ bundle install
Or install it yourself as:
$ gem install tuga
## Usage
### In the command line
Run the `tuga` command followed by a filename.
```
tuga soure_code.pt
```
### In an application
Require the `Tuga` transpiler and give it Tuga source code.
```ruby
require 'tuga/transpiler'
source_code = <<~BACALHAU
lista_de_frutas = ['maçã', 'manga', 'goiaba', 'uva']
por_cada fruta na lista_de_frutas fazer
escrever fruta.com_letra_maiuscula
fim
BACALHAU
transpiler = Tuga::Transpiler.new
transpiler.to_ruby(source_code)
```
## Development
After checking out the repo, run `bin/setup` to install dependencies, configure git hooks and create support files.
You can also run `bin/console` for an interactive prompt that will allow you to experiment.
The health and maintainability of the codebase is ensured through a set of
Rake tasks to test, lint and audit the gem for security vulnerabilities and documentation:
```
rake build # Build tuga-x.x.x.gem into the pkg directory
rake build:checksum # Generate SHA512 checksum if tuga-0.x.x.gem into the checksums directory
rake bundle:audit:check # Checks the Gemfile.lock for insecure dependencies
rake bundle:audit:update # Updates the bundler-audit vulnerability database
rake clean # Remove any temporary products
rake clobber # Remove any generated files
rake coverage # Run spec with coverage
rake install # Build and install tuga-x.x.x.gem into system gems
rake install:local # Build and install tuga-x.x.x.gem into system gems without network access
rake qa # Test, lint and perform security and documentation audits
rake release[remote] # Create tag vx.x.x and build and push tuga-x.x.x.gem to rubygems.org
rake rubocop # Run RuboCop
rake rubocop:auto_correct # Auto-correct RuboCop offenses
rake spec # Run RSpec code examples
rake verify_measurements # Verify that yardstick coverage is at least 100%
rake yard # Generate YARD Documentation
rake yard:junk # Check the junk in your YARD Documentation
rake yardstick_measure # Measure docs in lib/**/*.rb with yardstick
```
## Contributing
Bug reports and pull requests are welcome on GitHub at https://github.com/wilsonsilva/tuga. This project is intended to
be a safe, welcoming space for collaboration, and contributors are expected to adhere to the
[code of conduct](https://github.com/wilsonsilva/tuga/blob/main/CODE_OF_CONDUCT.md).
## License
The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
## Code of Conduct
Everyone interacting in the Tuga project's codebases, issue trackers, chat rooms and mailing lists is expected to
ollow the [code of conduct](https://github.com/wilsonsilva/tuga/blob/main/CODE_OF_CONDUCT.md).