https://github.com/silentvoid13/mcqconverter
MCQ format conversion tool (AMC-TXT to GIFT / GIFT to AMC-TXT)
https://github.com/silentvoid13/mcqconverter
converter format-converter gui mcq multiple-choice-questions
Last synced: about 9 hours ago
JSON representation
MCQ format conversion tool (AMC-TXT to GIFT / GIFT to AMC-TXT)
- Host: GitHub
- URL: https://github.com/silentvoid13/mcqconverter
- Owner: SilentVoid13
- License: agpl-3.0
- Created: 2020-07-06T14:44:54.000Z (almost 6 years ago)
- Default Branch: master
- Last Pushed: 2022-11-07T19:33:44.000Z (over 3 years ago)
- Last Synced: 2025-03-22T19:13:31.747Z (over 1 year ago)
- Topics: converter, format-converter, gui, mcq, multiple-choice-questions
- Language: Rust
- Homepage:
- Size: 4.49 MB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.TXT
Awesome Lists containing this project
README
# McqConverter
McqConverter is a [MCQ](https://en.wikipedia.org/wiki/Multiple_choice) format converter written in pure Rust.
## Supported Formats
McqConverter currently supports the following formats :
- [AMC-TXT](https://www.auto-multiple-choice.net/auto-multiple-choice.en/AMC-TXT.shtml)
- [GIFT](http://docs.moodle.org/en/GIFT)
You can suggest me a format that you want me to add by filling an [issue](https://github.com/SilentVoid13/McqConverter/issues).
## Usage
This repository contains 4 sub-projects.
### mcqconverter_gui
This is a GUI application that allows users to select and convert any of their files to the desired format.
### amctxt2gift
This is a console application to convert a file from the AMC-TXT format to the GIFT format
```bash
USAGE:
amctxt2gift [FLAGS] [OPTIONS]
FLAGS:
-c, --convert_comments Enables comments conversion (default: not enabled)
-h, --help Prints help information
-V, --version Prints version information
-v, --verbose Sets verbose output
OPTIONS:
-o, --output Sets the output file name (default: [FILE].gift)
ARGS:
Sets the input file to convert
```
### gift2amctxt
This is a console application to convert a file from the GIFT format to the AMC-TXT format
```bash
USAGE:
gift2amctxt [FLAGS] [OPTIONS]
FLAGS:
-c, --convert_comments Enables comments conversion
-h, --help Prints help information
-V, --version Prints version information
-v, --verbose Sets verbose output
OPTIONS:
-o, --output Sets the output file name (default: [FILE].amctxt)
ARGS:
Sets the input file to convert
```
### mcqconverter_core
This is the core library used to perform all the conversions. It is used by all the other projects. This project is not useful for users.
## Binaries
You can either get the compiled version from the latest [release](https://github.com/SilentVoid13/McqConverter/releases), from the [bin](https://github.com/SilentVoid13/McqConverter/tree/master/bin) directory, or compile it yourself using `cargo` :
```bash
cargo build --release
```
Your binaries will be available in the `target/release` directory.
This application has only been tested on Linux and Windows 64-bit.
## Contributing
Feel free to contribute. You can make a [pull request](https://github.com/SilentVoid13/McqConverter/pulls) to suggest any change you'd like to make.
## License
McqConverter is licensed under the GNU AGPLv3 license. Refer to [LICENSE](https://github.com/SilentVoid13/McqConverter/blob/master/LICENSE.txt) for more informations.