https://github.com/doir-lang/mizurunner

A runner for Mizu's Portable Format.

https://github.com/doir-lang/mizurunner

Science Score: 36.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
    Found .zenodo.json file
  • DOI references
  • Academic publication links
  • Committers with academic emails
    1 of 1 committers (100.0%) from academic institutions
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (9.2%) to scientific vocabulary
Last synced: 5 months ago · JSON representation

Repository

A runner for Mizu's Portable Format.

Basic Info
Statistics
  • Stars: 0
  • Watchers: 1
  • Forks: 0
  • Open Issues: 0
  • Releases: 2
Created 11 months ago · Last pushed 9 months ago
Metadata Files
Readme License

README.md

Mizu's Mascot

MizuRunner

Unlicensed Latest Release <!-- Checks -->

A simple executable wrapper around the Mizu assembly interpreter library. It takes as input a binary in Mizu's Portable Format and executes it.

```bash

On linux this looks like:

mizu hello.mizu

Or like this to see a printed trace of the instructions as they are executed

mizu-trace hello.mizu

A binary's "source code" can be examined by running

mizu hello.mizu --generate-header ```

Features

  • Lightweight Runtime (Only ~110kb)
  • Cross Platform (Windows, Linux, and Mac support).
  • Foreign Function Interface to native DLLs (Example: https://github.com/joshuadahlunr/MizuRunner/blob/master/examples/helloworlddumper.cpp).

Creating Mizu Binaries

Unfortunately Mizu doesn't have an assembler, thus to create a Mizu binary you need to write a simple C++ executable with code for the Mizu program embedded. You then need to call Mizu's toportable function and save the resulting binary blob to a file: ```cpp fp::raii::dynarraystd::byte portable = mizu::portable::toportable(programview, mizustack); std::ofstream fout("program.mizu", std::ios::binary | std::ios::out); fout.write((char*)portable.data(), portable.size()); ```

A full example program dumper can be found in: https://github.com/joshuadahlunr/MizuRunner/blob/master/examples/bubblesortdumper.cpp

License

The code in this repository is unlicensed, feel free to do whatever you want with it. However Mizu, Argparse, and Mio are all MIT Licensed.

Owner

  • Name: doir-lang
  • Login: doir-lang
  • Kind: organization

GitHub Events

Total
Last Year

Committers

Last synced: 9 months ago

All Time
  • Total Commits: 5
  • Total Committers: 1
  • Avg Commits per committer: 5.0
  • Development Distribution Score (DDS): 0.0
Past Year
  • Commits: 5
  • Committers: 1
  • Avg Commits per committer: 5.0
  • Development Distribution Score (DDS): 0.0
Top Committers
Name Email Commits
Joshua Dahl j****l@u****u 5
Committer Domains (Top 20 + Academic)
unr.edu: 1

Issues and Pull Requests

Last synced: 9 months ago

All Time
  • Total issues: 0
  • Total pull requests: 0
  • Average time to close issues: N/A
  • Average time to close pull requests: N/A
  • Total issue authors: 0
  • Total pull request authors: 0
  • Average comments per issue: 0
  • Average comments per pull request: 0
  • Merged pull requests: 0
  • Bot issues: 0
  • Bot pull requests: 0
Past Year
  • Issues: 0
  • Pull requests: 0
  • Average time to close issues: N/A
  • Average time to close pull requests: N/A
  • Issue authors: 0
  • Pull request authors: 0
  • Average comments per issue: 0
  • Average comments per pull request: 0
  • Merged pull requests: 0
  • Bot issues: 0
  • Bot pull requests: 0
Top Authors
Issue Authors
Pull Request Authors
Top Labels
Issue Labels
Pull Request Labels

Dependencies

.github/workflows/build-and-release.yml actions
  • actions/checkout v4 composite
  • actions/download-artifact v4 composite
  • actions/upload-artifact v4 composite
  • msys2/setup-msys2 v2 composite
  • softprops/action-gh-release v2 composite