https://github.com/foso/folders2kt

An interpreter/transpiler, written in Kotlin, for the esoteric programming language Folders, a language with no code and just folders
https://github.com/foso/folders2kt

esolang folders interpreter transpiler

Last synced: about 1 month ago
JSON representation

An interpreter/transpiler, written in Kotlin, for the esoteric programming language Folders, a language with no code and just folders

• Host: GitHub
• URL: https://github.com/foso/folders2kt
• Owner: Foso
• License: apache-2.0
• Created: 2021-12-12T17:52:29.000Z (over 3 years ago)
• Default Branch: main
• Last Pushed: 2025-02-26T07:25:00.000Z (about 2 months ago)
• Last Synced: 2025-02-26T08:29:20.174Z (about 2 months ago)
• Topics: esolang, folders, interpreter, transpiler
• Language: Kotlin
• Homepage:
• Size: 1.46 MB
• Stars: 33
• Watchers: 2
• Forks: 0
• Open Issues: 3
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
Folders2kt 📁

An Interpreter/Transpiler of the Folders esoteric programming language, a language with no code and just folders, written in Kotlin


[![justforfunnoreally.dev badge](https://img.shields.io/badge/justforfunnoreally-dev-9ff)](https://justforfunnoreally.dev)

[![jCenter](https://img.shields.io/badge/Apache-2.0-green.svg

)](https://github.com/Foso/Folders2kt/blob/master/LICENSE)

  

### Show some :heart: and star the repo to support the project

[![GitHub stars](https://img.shields.io/github/stars/Foso/Folders2kt.svg?style=social&label=Star)](https://github.com/Foso/Folders2kt) [![GitHub forks](https://img.shields.io/github/forks/Foso/Folders2kt.svg?style=social&label=Fork)](https://github.com/Foso/Folders2kt/fork) [![GitHub watchers](https://img.shields.io/github/watchers/Foso/Folders2kt.svg?style=social&label=Watch)](https://github.com/Foso/Folders2kt) [![Twitter Follow](https://img.shields.io/twitter/follow/jklingenberg_.svg?style=social)](https://twitter.com/jklingenberg_)

## Introduction

"Folders is a language where the program is encoded into a directory structure. All files within are ignored, as are the names of the folders. Commands and expressions are encoded by the pattern of folders within folders. "

Folders was created by Daniel Temkin https://danieltemkin.com/Esolangs/Folders/. If you want to learn more about the language, check https://www.youtube.com/watch?v=Igh-vBI2LXc

This is what a "Hello World"-program looks like:



  



Folders2kt can execute this programs on the JVM or print you Kotlin source code for it. 

### Run it

To execute a Folders program you need to add the directory path of the program with the "-d" parameter

 java -jar Folders2kt-1.0-SNAPSHOT-all.jar -d /Users/jklingenberg/Code/2021/Folders2kt/sample_programs/99Bottles 



  



### Print Source

To execute a Folders program you need the directory path of the program with the "-d" parameter and the "-source" parameter

 java -jar Folders2kt-1.0-SNAPSHOT-all.jar -d /Users/jklingenberg/Code/2021/Folders2kt/sample_programs/99Bottles -source 



  



# 🏠 Architecture

## 🛠️ Built With

### Kotlin

[![jCenter](https://img.shields.io/badge/Kotlin-2.0.0-green.svg

)]()

### Project Structure

* src/main - Source code of the interpreter

* sample_programs - Example programs I got from https://github.com/SinaKhalili/Folders.py

You need to extract the zips before you can run them.

## ✍️ Feedback

Feel free to send feedback on [Twitter](https://twitter.com/jklingenberg_) or [file an issue](https://github.com/foso/Folders2kt/issues/new). Feature requests are always welcome. 

## 📜 License

This project is licensed under the Apache License, Version 2.0 - see the [LICENSE.md](https://github.com/Foso/Folders2kt/blob/master/LICENSE) file for details

### Find this project useful ? :heart:

* Support it by clicking the :star: button on the upper right of this page. :v:

License

-------

    Copyright 2021 Jens Klingenberg

    Licensed under the Apache License, Version 2.0 (the "License");

    you may not use this file except in compliance with the License.

    You may obtain a copy of the License at

       http://www.apache.org/licenses/LICENSE-2.0

    Unless required by applicable law or agreed to in writing, software

    distributed under the License is distributed on an "AS IS" BASIS,

    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.

    See the License for the specific language governing permissions and

    limitations under the License.