Skip to content

gus-caribe/bfck

Repository files navigation

Image

    This is bfck, a CLI interpreter for brainf**ck esolang written in Dart.

Motivation

    This application was developed as an experiment to practice my abilities and to have fun during the process.

    The developer tried to implement the behavior described in this documentation. The application includes a few options and flags that allow the user to interfere with the default interpreter behavior.

    Here is a simplified tree that represents the pathways you can take with the commands, options, flags and arguments that can be passed to the application.

Image

Activation

You can activate the application using Dart SDK:

You must have Dart SDK configured in your machine (see how).

  • Option 1:
    • You can activate the application directly via the following command:
    dart pub global activate --source git https://github.com/gus-caribe/bfck
  • Option 2:

    You must have GIT installed (see how).

    • You can clone this repository:
    git clone https://github.com/gus-caribe/bfck
    • Then go into the cloned repository directory:
    cd bfck
    • And then activate it using the following command:
    dart pub global activate --source path .

    After that, you're all set! You can execute bfck command from any directory and explore the options adding the --help flag.

Image

Contribute

  • You can open any issues to offer suggestions, report bugs and much more.
  • I am currently struggling to find a way to implement a compile option to generate native executables for brainf**k files. I've already checked dart_eval, but I'd like to compile to machine code, not Dart binaries. If you have any suggestions, you are more than welcome to leave it in a new issue.

Versioning

  • Cosmetic improvement: X.X.X+^

Ex.: [3.1.4 -> 3.1.4+1], [3.1.4+1 -> 3.1.4+2].

  • Bug fixed / adaptation made: X.X.^--

Ex.: [3.1.4+2 -> 3.1.5].

  • Feature added: X.^.0--

Ex.: [3.1.5 -> 3.2.5].

  • Unit tests covered: X.0.0--

Ex.: [3.2.5 -> 4.0.0].

Donate

  • PayPal
    paypal
  • Buy me a coffee
    "Buy Me A Coffee"

License

MIT