Implementation of the Folders📂 esoteric programming language, a language with no code and just folders.

Last update: Dec 17, 2022

Overview

Folders.py

Folders is an esoteric programming language, created by Daniel Temkin in 2015, which encodes the program entirely into the directory structure.

All names of the folders as well as their contents are completely ignored. Instead, the commands are encoded in the nesting of folders within folders.

Let me say that again: THE SOURCE CODE IS THE DIRECTORY STRUCTURE. Lol.

This is a Python implementation of Folders for all to enjoy!

Folders is (was originally) implemented in C#.

Usage

Install from pip

Simply install the Folders command line interpreter

pip install Folders

Give the folder of the program you wish to run as an command line argument

Folders sample_programs/HelloWorld
# => Hello, World!

If instead you would like list the Python code to stdout, use the -l option

Folders -l sample_programs/HelloWorld
# => print("Hello, World!", end='', flush=True)

Run python

The implementation is just the python file, folders.py and has no dependencies, so if you'd like you can clone the repo and run python ./folders/folders.py instead of pip installing and use it the same as in the examples above.

Language details

The language details are on the esolangs wiki, but I've put it here for reference.

For example, take a look at the Fibonacci sample program.

The root folder contains a list of command folders - in this case labelled Nf1.., Nf2.., but the names don't actually matter except the alphabetical ordering - the first folder (which I've labelled with an init) is the first "sub-folder", the next is the second, etc.

Commands:

Commands take the following form

Command	# of folders	Details
if	0 folders	Second sub-folder holds expression, third holds list of commands
while	1 folder	Second sub-folder holds expression, third holds list of commands
declare	2 folders	Second sub-folder holds type, third holds var name (in number of folders, ex. zero folders becomes "var_0")
let	3 folders	Second sub-folder hold variable name (in number of folders), third holds an expression
print	4 folders	Second sub-folder holds expression
input	5 folders	Second sub-folder holds variable name

Expressions:

Expression folders take the following form:

Type	# of folders	Details
Variable	0 folders	Second sub-folder holds variable name
Add	1 folder	Second sub-folder holds the first expression to add, third holds second expression
Subtract	2 folders	Second sub-folder holds the first expression to subtract, third holds second expression
Multiply	3 folders	Second sub-folder holds the first expression to multiply, third holds second expression
Divide	4 folders	Second sub-folder holds the first expression to divide, third holds second expression
Literal Value	5 folders	Second sub-folder holds the type of the value (as described by types below, ex. two folders for a string)
Equal To	6 folders	Second and third folders hold expressions to compare
Greater Than	7 folders	Second and third folders hold expressions to compare (takes the form : second folder > third folder)

Types

And finally type folders take the following form:

Type	# of folders
int	0 folders
float	1 folder
string	2 folders
char	3 folders

Note on this implemementation

The int, float, and char types are 8-bit only. But, you can add into their variables to arbitrary length, so to get a very large number you can simply multiply it a bunch of times.

This is what the fibonacci program does.

The absolute power of folders

Behold, the mighty Truth Machine program:

A mighty meme-worthy point

All Folders programs are 0 bytes if you're on windows as it interprets an empty folder as 0 bytes.

The ultimate code golf!

Links

You might also like...

sawa (ꦱꦮ) is an open source programming language, an interpreter to be precise, where you can write python code using javanese character.

ꦱꦮ sawa (ꦱꦮ) is an open source programming language, an interpreter to be precise, where you can write python code using javanese character. sawa iku

307 Jan 7, 2023

Comments

Why no no work

i typed "Folders helloworld"

Traceback (most recent call last):
  File "C:\Users\jerem\AppData\Local\Programs\Python\Python39\lib\runpy.py", line 197, in _run_module_as_main
    return _run_code(code, main_globals, None,
  File "C:\Users\jerem\AppData\Local\Programs\Python\Python39\lib\runpy.py", line 87, in _run_code
    exec(code, run_globals)
  File "C:\Users\jerem\AppData\Local\Programs\Python\Python39\Scripts\Folders.exe\__main__.py", line 4, in <module>
ModuleNotFoundError: No module named 'folders'

opened by Jeremy5909 6

I just found out a bug

If you type your program named "Hello, World!" then the "Folders [-l] <Folder's name>" will not work

It will say: "Folders: error: unrecognized arguments: World!

Picture will maybe make everything clearer

@SinaKhalili @georgewoodall82

opened by TryHardCode1 2
Why does the info about commands in FOLDERS so confusing

I have a problem when making a program in FOLDERS

Basically, if you want to print a string, you'll need 4 Folders inside a command folder to work. But the picture from https://danieltemkin.com/Esolangs/Folders/ shows that the print command actually needs 5 Folders. How is that possible???

opened by TryHardCode1 0
more features

folders is an epic programming language already so why not make it better? suggestion - make a v2 or just build onto the existing version where there are more commands and expressions examples - boolean data type, logic expressions (and/or/not), else/elif, etc.

opened by ProfessorDragon 4

Releases(v0.0.5)

v0.0.5(Dec 13, 2021)
Thanks to @georgewoodall82 for integer number input support

Added github action workflow so now PyPI should update on new tag pushes 🚀

👉🏽 https://pypi.org/project/Folders/0.0.5/
Source code(tar.gz)
Source code(zip)

Implementation of the Folders📂 esoteric programming language, a language with no code and just folders.

Related tags

Overview

Folders.py

Usage

Install from pip

Run python

Language details

Commands:

Expressions:

Types

Note on this implemementation

The absolute power of folders

A mighty meme-worthy point

Links

You might also like...

sawa (ꦱꦮ) is an open source programming language, an interpreter to be precise, where you can write python code using javanese character.

Eros is an expiremental programming language built using simple Python code.

lets learn Python language with basic examples. highly recommended for beginners who just start coding.

Built with Python programming language and QT library and Guess the number in three easy, medium and hard rolls

Built with Python programming language and QT library and Guess the number in three easy, medium and hard rolls

This repository containing cross-section cut and fill calculations using Python programming language.

The worst and slowest programming language you have ever seen

A complex language with high level programming and moderate syntax.

Short, introductory guide for the Python programming language

Comments

Why no no work

I just found out a bug

Why does the info about commands in FOLDERS so confusing

more features

Releases(v0.0.5)

v0.0.5(Dec 13, 2021)

Owner

Sina Khalili

A synchronous, single-threaded interface for starting processes on Linux

World's best free and open source ERP.

The earliest beta version of pytgcalls on Linux x86_64 and ARM64! Use in production at your own risk!

Integration between the awesome window manager and the firefox web browser.

An early stage integration of Hotwire Turbo with Django

Write complicated anonymous functions other than lambdas in Python.

Python client library for the Databento API

Malicious Document IoC Extractor is a collection of scripts that helps extracting IoCs from various maldoc families.

Swim between bookmarks in the Windows terminal

Webcash is an experimental e-cash (electronic cash)

30DaysOfCode-PhoenixClub - Solution of everyday coding problem given in 30DaysofCode contest held on Hackerrank

Buffer overflow example for python

A web application (with multiple API project options) that uses MariaDB HTAP!

MindF**k it's a programming language as BrainFuck, but with some cool features.

Pygments is a generic syntax highlighter written in Python

A platform for developers 👩‍💻 who wants to share their programs and projects.

A very small (15 lines of code) and beautiful fetch script (exclusively for Arch Linux).

Ml-design-patterns - Source code accompanying O'Reilly book: Machine Learning Design Patterns

A simple wrapper for joy library

Download and process GOES-16 and GOES-17 data from NOAA's archive on AWS using Python.