# Flote
<br>
<div align="center">
<img src="https://raw.githubusercontent.com/icarogabryel/flote/refs/heads/main/docs/logo.png" width="40%" alt="Flote logo"/>
</div>
<br>
<div align="center">
<img alt="GitHub Repo stars" src="https://img.shields.io/github/stars/icarogabryel/flote?style=flat&logo=github">
<img alt="GitHub Release" src="https://img.shields.io/github/v/release/icarogabryel/flote?color=green">
<img alt="PyPI - Version" src="https://img.shields.io/pypi/v/flote?color=green">
<img src="https://img.shields.io/github/license/icarogabryel/flote" alt="license"/>
</div>
<!-- stars, last release, pypi, readthedocs, reddit, license-->
## 🛸 Introduction
Flote is a hardware description language and Python framework for hardware simulation. It is designed to be **friendly, simple, light and productive**. More easy to use and learn than Verilog and VHDL. Using Flote, you can create integrated circuits component by using it's HDL and/or Python framework that work by the HLS (High Level Synthesis) concept.
<div align="center">
<img src="https://raw.githubusercontent.com/icarogabryel/flote/refs/heads/main/docs/print.png" width="90%" alt="Flote logo"/>
</div>
Here is an example of a half adder in Flote:
```flote
comp halfAdder {
in bit a;
in bit b;
out bit sum = a xor b;
out bit carry = a and b;
}
```
## ⚙️ How it works
Flote's Evaluator uses a structure of a compiler's front-end to elaborate the component. It has a scanner, parser and a builder. This last one is responsible for build the component, an object that can be manipulated in Python and simulates the behavior of the integrated circuit. The model object it's a set of signals buses and uses event driven algorithm and dynamic programming to simulate the behavior of the circuit.
Using the HLS side, you can create the component "by hand". Also with the use of the Python package you can manipulate the signals and sava then in a waveform file.
## 🚀 Release
Flote is in beta development. You can see the latest releases in [the GitHub repository](https://github.com/icarogabryel/flote/releases).
## 📝 To Do List
- [X] Make the simulator class
- [X] Make EBNF for the language
- [X] Make Scanner
- [X] Make Parser
- [X] Make Builder
- [X] Make accept expressions
- [X] Improve the algorithm of simulation
- [X] Improve structure
- [X] Improve declaration and assignment
- [X] Improve Semantic Analysis
- [X] Create waveform class
- [X] Add line number in semantic errors
- [X] Improve testbench methods
- [ ] Add multi-dimensional bit signals support
- [ ] Declaration
- [ ] Assignment
- [ ] Operation
- [ ] Error handling
- [ ] Indexing
- [ ] Slicing
- [ ] Concatenation
- [ ] Big endian support
- [ ] N-Dimensional arrays support
- [ ] Add sub-components support
- [ ] Add Python calls support
- [ ] Improve HLS support
- [ ] Add manual time control
- [ ] Add others file types support for waveforms
Raw data
{
"_id": null,
"home_page": "https://github.com/icarogabryel/flote",
"name": "flote",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": "HDL, simulation, Python, framework, friendly, simple, productive",
"author": "\u00cdcaro Gabryel",
"author_email": "icarogabryel2001@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/5d/ae/09abc81e61eb2095917dcad362be4e59bfd3a7ecb48c4b1cd5a2ddcf84b8/flote-0.2.0.tar.gz",
"platform": null,
"description": "# Flote\r\n\r\n<br>\r\n<div align=\"center\">\r\n <img src=\"https://raw.githubusercontent.com/icarogabryel/flote/refs/heads/main/docs/logo.png\" width=\"40%\" alt=\"Flote logo\"/>\r\n</div>\r\n<br>\r\n<div align=\"center\">\r\n <img alt=\"GitHub Repo stars\" src=\"https://img.shields.io/github/stars/icarogabryel/flote?style=flat&logo=github\">\r\n <img alt=\"GitHub Release\" src=\"https://img.shields.io/github/v/release/icarogabryel/flote?color=green\">\r\n <img alt=\"PyPI - Version\" src=\"https://img.shields.io/pypi/v/flote?color=green\">\r\n <img src=\"https://img.shields.io/github/license/icarogabryel/flote\" alt=\"license\"/>\r\n</div>\r\n\r\n<!-- stars, last release, pypi, readthedocs, reddit, license-->\r\n\r\n## \ud83d\udef8 Introduction\r\n\r\nFlote is a hardware description language and Python framework for hardware simulation. It is designed to be **friendly, simple, light and productive**. More easy to use and learn than Verilog and VHDL. Using Flote, you can create integrated circuits component by using it's HDL and/or Python framework that work by the HLS (High Level Synthesis) concept.\r\n\r\n<div align=\"center\">\r\n <img src=\"https://raw.githubusercontent.com/icarogabryel/flote/refs/heads/main/docs/print.png\" width=\"90%\" alt=\"Flote logo\"/>\r\n</div>\r\n\r\nHere is an example of a half adder in Flote:\r\n\r\n```flote\r\ncomp halfAdder {\r\n in bit a;\r\n in bit b;\r\n\r\n out bit sum = a xor b;\r\n out bit carry = a and b;\r\n\r\n}\r\n```\r\n\r\n## \u2699\ufe0f How it works\r\n\r\nFlote's Evaluator uses a structure of a compiler's front-end to elaborate the component. It has a scanner, parser and a builder. This last one is responsible for build the component, an object that can be manipulated in Python and simulates the behavior of the integrated circuit. The model object it's a set of signals buses and uses event driven algorithm and dynamic programming to simulate the behavior of the circuit.\r\n\r\nUsing the HLS side, you can create the component \"by hand\". Also with the use of the Python package you can manipulate the signals and sava then in a waveform file.\r\n\r\n## \ud83d\ude80 Release\r\n\r\nFlote is in beta development. You can see the latest releases in [the GitHub repository](https://github.com/icarogabryel/flote/releases).\r\n\r\n## \ud83d\udcdd To Do List\r\n\r\n- [X] Make the simulator class\r\n- [X] Make EBNF for the language\r\n- [X] Make Scanner\r\n- [X] Make Parser\r\n- [X] Make Builder\r\n- [X] Make accept expressions\r\n- [X] Improve the algorithm of simulation\r\n- [X] Improve structure\r\n- [X] Improve declaration and assignment\r\n- [X] Improve Semantic Analysis\r\n- [X] Create waveform class\r\n- [X] Add line number in semantic errors\r\n- [X] Improve testbench methods\r\n- [ ] Add multi-dimensional bit signals support\r\n - [ ] Declaration\r\n - [ ] Assignment\r\n - [ ] Operation\r\n - [ ] Error handling\r\n - [ ] Indexing\r\n - [ ] Slicing\r\n - [ ] Concatenation\r\n - [ ] Big endian support\r\n - [ ] N-Dimensional arrays support\r\n- [ ] Add sub-components support\r\n- [ ] Add Python calls support\r\n- [ ] Improve HLS support\r\n- [ ] Add manual time control\r\n- [ ] Add others file types support for waveforms\r\n",
"bugtrack_url": null,
"license": "GPL-3.0",
"summary": "Flote is a HDL and Python framework for simulation. Designed to befriendly, simple, and productive. Easy to use and learn.",
"version": "0.2.0",
"project_urls": {
"Homepage": "https://github.com/icarogabryel/flote"
},
"split_keywords": [
"hdl",
" simulation",
" python",
" framework",
" friendly",
" simple",
" productive"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "f2d5f59909d6202307d86ece46605d815f9fe5212582a57ee3a637bf88a55f19",
"md5": "9318ddeda82b96b68bd9690e7aa598ca",
"sha256": "11c42b6f95db80a0cb9a3dc30b6f508c47b53247a03574eb954a4dd4f825d3c7"
},
"downloads": -1,
"filename": "flote-0.2.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "9318ddeda82b96b68bd9690e7aa598ca",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 15280,
"upload_time": "2025-09-07T21:11:38",
"upload_time_iso_8601": "2025-09-07T21:11:38.663977Z",
"url": "https://files.pythonhosted.org/packages/f2/d5/f59909d6202307d86ece46605d815f9fe5212582a57ee3a637bf88a55f19/flote-0.2.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "5dae09abc81e61eb2095917dcad362be4e59bfd3a7ecb48c4b1cd5a2ddcf84b8",
"md5": "4ad7109160941174fa5c30bacbd07fd7",
"sha256": "c22d057f6b9e2755a6adf06a74adc504f424357c21fea3e5a816ab97ea28a77c"
},
"downloads": -1,
"filename": "flote-0.2.0.tar.gz",
"has_sig": false,
"md5_digest": "4ad7109160941174fa5c30bacbd07fd7",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 15323,
"upload_time": "2025-09-07T21:11:39",
"upload_time_iso_8601": "2025-09-07T21:11:39.492557Z",
"url": "https://files.pythonhosted.org/packages/5d/ae/09abc81e61eb2095917dcad362be4e59bfd3a7ecb48c4b1cd5a2ddcf84b8/flote-0.2.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-09-07 21:11:39",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "icarogabryel",
"github_project": "flote",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"requirements": [
{
"name": "certifi",
"specs": [
[
"==",
"2025.6.15"
]
]
},
{
"name": "charset-normalizer",
"specs": [
[
"==",
"3.4.2"
]
]
},
{
"name": "docutils",
"specs": [
[
"==",
"0.21.2"
]
]
},
{
"name": "id",
"specs": [
[
"==",
"1.5.0"
]
]
},
{
"name": "idna",
"specs": [
[
"==",
"3.10"
]
]
},
{
"name": "jaraco.classes",
"specs": [
[
"==",
"3.4.0"
]
]
},
{
"name": "jaraco.context",
"specs": [
[
"==",
"6.0.1"
]
]
},
{
"name": "jaraco.functools",
"specs": [
[
"==",
"4.2.1"
]
]
},
{
"name": "keyring",
"specs": [
[
"==",
"25.6.0"
]
]
},
{
"name": "markdown-it-py",
"specs": [
[
"==",
"3.0.0"
]
]
},
{
"name": "mdurl",
"specs": [
[
"==",
"0.1.2"
]
]
},
{
"name": "more-itertools",
"specs": [
[
"==",
"10.7.0"
]
]
},
{
"name": "nh3",
"specs": [
[
"==",
"0.2.21"
]
]
},
{
"name": "packaging",
"specs": [
[
"==",
"25.0"
]
]
},
{
"name": "Pygments",
"specs": [
[
"==",
"2.19.2"
]
]
},
{
"name": "pywin32-ctypes",
"specs": [
[
"==",
"0.2.3"
]
]
},
{
"name": "readme_renderer",
"specs": [
[
"==",
"44.0"
]
]
},
{
"name": "requests",
"specs": [
[
"==",
"2.32.4"
]
]
},
{
"name": "requests-toolbelt",
"specs": [
[
"==",
"1.0.0"
]
]
},
{
"name": "rfc3986",
"specs": [
[
"==",
"2.0.0"
]
]
},
{
"name": "rich",
"specs": [
[
"==",
"14.0.0"
]
]
},
{
"name": "setuptools",
"specs": [
[
"==",
"80.9.0"
]
]
},
{
"name": "twine",
"specs": [
[
"==",
"6.1.0"
]
]
},
{
"name": "urllib3",
"specs": [
[
"==",
"2.5.0"
]
]
},
{
"name": "wheel",
"specs": [
[
"==",
"0.45.1"
]
]
}
],
"lcname": "flote"
}
JSON
