Skip to main content

a very simple brainfuck interpreter.

Project description

simple_brainfuck

a very simple brainfuck interpreter.

Install

pip install simple-brainfuck

Python Usage

import simple_brainfuck

# simple usage
bf_program = "++++++++[>++++[>++>+++>+++>+<<<<-]>+>+>->>+[<]<-]>>.>---.+++++++..+++.>>.<-.<.+++.------.--------.>>+.>++."
mem, time_cost = simple_brainfuck.run(bf_program)

# run with input, output hook
# through memory_status,you can access the program memory space
def input_hook(memory_status:dict[int, int]) -> int:
    import sys
    try:
        return ord(sys.stdin.read(1)) % 256
    except:
        return 255
def output_book(memory_status:dict[int, int], c:int):
    print(chr(c), end="")
simple_brainfuck.run(bf_program, input_hook=input_hook, output_hook=output_hook)

# run program, finally output the memory statue
simple_brainfuck.run(bf_program, show_memory=True)

# run program, finally output time cost
# time cost does not include preprocessing time, just program running time
simple_brainfuck.run(bf_program, show_time=True)

CLI Usage

# run in CLI mode
python3 -m simple_brainfuck

# run file as program
python3 -m simple_brainfuck <filepath.bf>

# run file, output time cost
python3 -m simple_brainfuck <filepath.bf> --show-time
python3 -m simple_brainfuck <filepath.bf> -t

# run file, output final memory status
python3 -m simple_brainfuck <filepath.bf> --show-memory
python3 -m simple_brainfuck <filepath.bf> -m

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

simple_brainfuck-0.1.1.tar.gz (3.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

simple_brainfuck-0.1.1-py3-none-any.whl (4.9 kB view details)

Uploaded Python 3

File details

Details for the file simple_brainfuck-0.1.1.tar.gz.

File metadata

  • Download URL: simple_brainfuck-0.1.1.tar.gz
  • Upload date:
  • Size: 3.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/2.3.2 CPython/3.13.12 Windows/11

File hashes

Hashes for simple_brainfuck-0.1.1.tar.gz
Algorithm Hash digest
SHA256 3c0531418df7904ecc3665c759c140b6aeb70dfe41664cd5c4ae7413002a6a4b
MD5 bfc0d80ed3038871e77064c5f243a7ad
BLAKE2b-256 15840e730e5213859eff6207e5ffd7cdb5affeae13f630218bd39925228ba87b

See more details on using hashes here.

File details

Details for the file simple_brainfuck-0.1.1-py3-none-any.whl.

File metadata

  • Download URL: simple_brainfuck-0.1.1-py3-none-any.whl
  • Upload date:
  • Size: 4.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/2.3.2 CPython/3.13.12 Windows/11

File hashes

Hashes for simple_brainfuck-0.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 b400b37d543d40eac4beed0920bb12f978b76e288853f74ef8280ff219a090b8
MD5 b6a84d02b821be2a4260acda2789058e
BLAKE2b-256 0387fa471a24b0c2dedd21021d153946b7bf553180940c1c0d0c1de7b187e5bf

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page