Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/wazery/norby
This is a simple CLI program that is a simulation of a simple toy robot moving on a square tabletop, of dimensions 5 units x 5 units.
https://github.com/wazery/norby
Last synced: about 1 month ago
JSON representation
This is a simple CLI program that is a simulation of a simple toy robot moving on a square tabletop, of dimensions 5 units x 5 units.
- Host: GitHub
- URL: https://github.com/wazery/norby
- Owner: wazery
- Created: 2015-11-28T14:35:28.000Z (almost 9 years ago)
- Default Branch: master
- Last Pushed: 2015-11-29T03:35:06.000Z (almost 9 years ago)
- Last Synced: 2024-05-10T22:05:46.894Z (6 months ago)
- Language: Ruby
- Homepage:
- Size: 7.81 KB
- Stars: 2
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
[](https://travis-ci.org/wazery/norby)
[](https://codeclimate.com/github/wazery/norby)
# Norby
This is a simple CLI program that is a simulation of a simple toy robot moving on a square tabletop, of dimensions 5 units x 5 units.
## Naming
> The name is derived from the fictional robot Norby, that small but very productive robot!
## It works according to the following specifications:
- There are no other obstructions on the table surface.
- The robot is free to roam around the surface of the table, but must be prevented from falling to destruction.
- Any movement that would result in the robot falling from the table must be prevented, however further valid movement commands must still be allowed.
## It can read the following form:
```
PLACE X,Y,F
MOVE
LEFT
RIGHT
REPORT
```
- **PLACE** will put the toy robot on the table in position X,Y and facing NORTH, SOUTH, EAST or WEST.
- The origin (0,0) can be considered to be the SOUTH WEST most corner.
- The first valid command to the robot is a **PLACE** command, after that, any sequence of commands may be issued, in any order, including another PLACE command. The application should discard all commands in the sequence until a valid PLACE command has been executed.
- **MOVE** will move the toy robot one unit forward in the direction it is currently facing.
- **LEFT** and RIGHT will rotate the robot 90 degrees in the specified direction without changing the position of the robot.
- **REPORT** will announce the X,Y and orientation of the robot.
- A robot that is not on the table can choose to ignore the MOVE, LEFT, RIGHT and REPORT commands.
- Provide test data to exercise the application.
## Constraints:
The toy robot must not fall off the table during movement. This also includes the initial placement of the toy robot.
Any move that would cause the robot to fall must be ignored.
## Installation
Add this line to your application's Gemfile:
$ gem install norby
And then execute:
$ norby
## Example Input and Output:
### a)
```
PLACE 0,0,NORTH
MOVE
REPORT
Output: 0,1,NORTH
```
### b)
```
PLACE 0,0,NORTH
LEFT
REPORT
Output: 0,0,WEST
```
### c)
```
PLACE 1,2,EAST
MOVE
MOVE
LEFT
MOVE
REPORT
Output: 3,3,NORTH
```
## Development
After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec ---` 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 tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
## Contributing
Bug reports and pull requests are welcome on GitHub at https://github.com/wazery/norby.