Passant Manifesto (please 'star' this repository. if we get over 100 stars, I'll put the right parenthesis back.

A programming language made up of chess games

Passant is a programming language (which some may describe as esoteric ).

The alphabet of the language is composed of the set of all possible complete or incomplete chess games (rigorously: a chess game is any sequence of legal chess moves, after the chessboard has been set up to the chess starting position). We offer the working compiler in this github repo as an example of the language.

The abstract notion of a chess game is, while intriguing, not convenient for computers, so in our implementation, we concretize a "chess game" as a string which represents a chess game in PGN.

However, we don't presume to constrain all implementations of the language to this specific definition of "chess game", and so you may indeed play programs in this language by yourself or with a friend on a physical chessboard.

This compiler can be viewed at /compiler.js and heavily uses the open-source chess.js library to do the hard work of parsing the algebraic notation of games in PGN and translating those to board states (which are intermediarily represented in FEN).

What is Passant?: An Explanation in English

t0-do

KASTLE: Kevin-Aziz-Suasin-Transposition-Lumping-Encoding

(documentation in progress)
We define a new method of encoding a chessboard state to a sequence of bits.

The KASTL Encoding of this board-state is 000111010

Informally, to get the KASTLE of a chessboard state, you view the chessboard, top-down, from White's perspective. Then, you scan the chessboard row-by-row top-to-bottom, left-to-right. (Like reading lines of text.) Construct a bitstring by appending a 1 every time you encounter a white piece, and adding a 0 every time you encounter a black piece. So, for example, the starting position would be '00000000000000001111111111111111'. Then, you match as many 0s from the beginning and 1s from the end as you can, and delete them. In essence, any leading 0 annihilates with any trailing 1. So, the starting position then becomes '' (the empty string).

Python pseudocode:

def KASTLE(board):
	bits = ''
	for row in board: #from 8 to 1
		for cell in row: #from a to h
			if cell.contains_white_piece():
				bits+='1'
			elif cell.contains_black_piece():
				bits+='0'
	#remove an equal amount of leading 0s and trailing 1s
	while(bits[0] == '0' and bits[-1] == '1'):
		bits = bits[1:-1]
	return bits

Language Philosophy: Guiding Principles

The vision for Passant was to provide a programming language that espoused the elegance of the game of chess. In designing Passant, we want to chase the beauty found in the emergent behavior and metagame of so few simple rules. We also wanted to take advantage of the huge state-spaces found in chess (such as the huge amount of legal board-states, or the huger amount of legal games). In version 0.01, we feel like we have accomplished these goals "adequately" on a scale of "eh" to "good".

Passant in French means "pass". When people go straight, we pass them up. They go this way _ and we go this way /.Together, it's like this: _/.

Coding in Passant: A Style Guide.

Although Passant is trivially turing-complete (since there are Passant aliases for every javascript built-in and therefore supports loops and conditionals), and thus can be used for practical applications, such as programming your responsive single-page application, or an in-browser operating system, or a web server, we believe that coding in Passant should be beautiful, imaginative, and fun.

So that's why you have to adhere to this strict and rigorous set of rules when you program in our language, or else face excommunication from the Passant community.

1. You can never use the same game twice.

Let's say you wanted to program the built-in word "for" in your program. So you find out the KASTLE result that you need, and use your creativity and ingenuity to play a game that maps to the built-in "for". As you continue programming, you soon need to program another for loop, and thus you go back and copy-paste the same PGN that you already discovered which maps to "for", because efficiency is the goal of programming, right? WRONG! YOU ARE EXCOMMUNICATED! IMPEACHED! FOREVER EXILED! This is NOT ALLOWED!
Shed from yourself all preconceived notions that you have about programming that it should be quick and efficient. Forget forever the idea that you should constantly be seeking the fastest way to construct your program. When a pawn performs the move "en passant", it does not seek to follow the path of other pawns. It does not even seek to move in the opposite direction. No. Instead, a pawn performing "en passant" bypasses other individuals altogether. Likewise, you, as a Passant programmer, must bypass the conventional idea that programming is just a means to the final program. Copy-pasting, retyping, memorizing, or looking up some table to find the game that maps to the KASTLE that you want is rote, mundane, and conformist. Don't be a sheep. When programming in Passant, each new game in your program is an opportunity to play out a new game of chess to find the KASTLE that you desire.