https://github.com/rigbir/assembly_library
https://github.com/rigbir/assembly_library
assembly assembly-library dosbox low-level-programming macros nasm
Last synced: 2 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/rigbir/assembly_library
- Owner: Rigbir
- License: apache-2.0
- Created: 2025-02-10T18:36:41.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-08-21T08:26:35.000Z (10 months ago)
- Last Synced: 2025-12-25T22:34:51.580Z (6 months ago)
- Topics: assembly, assembly-library, dosbox, low-level-programming, macros, nasm
- Language: Assembly
- Homepage: https://rigbir.github.io/Assembly_Library/
- Size: 3.24 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Assembly Library for x86 (i8086)
This project is licensed under the [Apache License 2.0](LICENSE).
**Assembly Library for x86** — It is a macro library for the i8086 assembler, designed for user-friendly operation. It simplifies the development of assembly language programs by providing ready-made solutions for basic operations.
## Features
**Easy to use** — minimizes routine in assembly programming.
**Runs on NASM** — compatible with **Mac OS**, **Linux**, **Windows**.
**C-like syntax** — makes assembly code more readable.
## Demonstration
**Want to see the library in action?**
Check out the [**Test Program**](https://github.com/Rigbir/Assembly_Library/blob/main/TestLib.asm), which demonstrates most of the library's functions.
## Documentation
**Explore the full documentation for detailed descriptions of all available macros.**
[**Online Documentation**](https://rigbir.github.io/Assembly_Library/)
[**English Version**](https://github.com/Rigbir/Assembly_Library/blob/main/Documentations/Documentation_EN.md)
[**Russian Version**](https://github.com/Rigbir/Assembly_Library/blob/main/Documentations/Documentation_RU.md)
## A minimal overview of the features
Input and Output of strings (`print`, `println`, `print_multi`, `print_inline`)
Operations with strings (`strlen`, `strcopy`, `strcmp`, `substr`, `concat`)
Various conversions (`int_to_str`, `str_to_int`, `int_to_bin`)
And other features
## Installation and use
1. **Clone this repository**:
```sh
git clone https://github.com/Rigbir/Assembly_Library.git
```
2. **Move the library file to your project folder**:
```sh
mv MarLib.asm /path_to_your_work-folder
```
3. **Use library in your code**:
```asm
%include "MarLib.asm"
```
4. **Use the macros you need**:
```asm
section .data
msg db "Hey, this is MarLib function$!"
section .text
print msg
```
5. **After, compile your file and run**:
```sh
nasm -f bin examples.asm -o examples.com
dosbox examples.com
```
## Get Involved & Feedback
Have suggestions, found an issue, or want to improve the library?
Feel free to contribute, ask questions, or start discussions!
**Ways to connect:**
Open an [Issue](https://github.com/Rigbir/Assembly_Library/issues) to report a bug or suggest an improvement.
Feel free to fork and submit a **Pull Request** with your contributions!
Your feedback and contributions help make this library better!