
lisp
databricks, 2019
July 18th, 2024suno
Lyrics
Learn
Wiki
News
Community
Style Guide
Introduction
This is an opinionated guide to writing good, maintainable Common Lisp code.
This page is largely based on Google’s Common Lisp Style Guide and Ariel Networks’ own guide.
Contents
Introduction
Contents
General Guidelines
Use Libraries
Write Libraries
Naming
General style
Variables
Predicates
Don’t prefix package names
Formatting
Indentation
Line length
File header
Documentation
Docstrings everywhere
Comment Hierarchy
Do not use comments to erase code
CLOS
Slot options
Use the :TYPE slot option
Flow Control
Use WHEN, UNLESS
Keep conditions short
Packages
One Package Per File
Avoid :USE
Hierarchical Package Names
Project Structure
Directory Structure
System Definitions
The README
Use Continuous Integration services
General Guidelines
Use Libraries
Look for libraries that solve the problems you are trying to solve before embarking on a project. Making a project with no dependencies is not some sort of virtue. It doesn’t aid portability and it doesn’t help when it comes to turning a Lisp program into an executable.
Writing a library that solves the same problem as another hurts consolidation. Generally, you should only do this if you are going to make it worth it: Good, complete documentation, examples, and a well-designed website are – taken together – a good reason to write an alternative library to an existing one.
As always, check the licensing information of the libraries you use for incompatibilities.
Write Libraries
Before starting a project, think about its structure: Does every component have to be implemented within the project? Or are there parts that might be usable by others? If so, split the project into libraries.
If you set out to write a vast monolith and then lose interest, you will end up with 30% of an ambitious project, completely unusable to others because it’s bound to the rest of the unfinished code.
If you think of your project as a collection of independent libraries, bound together by a thin layer of domain-specific functionality, then if you lose interest in a project you will have left a short trail of useful libraries for others to use and build upon.
In short: write many small libraries.
Naming
General style
Names are lowercase, separated by single dashes (-), and they are complete words. That is, you should write user-count rather than user-cnt and make-text-node is better mk-txt-node.
Variables
Special variables (Mutable globals) should be surrounded by asterisks. These are called earmuffs.
For example:
(defparameter *positions* (make-array ...))
(defparameter *db* (make-hash-table))
Constants should be surrounded with plus signs. For example:
(defconstant +golden-ratio+ 1.6180339)
(defconstant +allowed-operators+ '(+ - * / expt))
Predicates
A predicate is a function that, given some input, returns
Recommended

Haunted Hearts
electro swing,jazz

情報セキュリティ報告書2023超サマリ曲
Hip-hop, mid-tempo

Night owls
Power metal, intense, epic, ethereal

Michael Way's Night
dance 90s girl pop

Spark in the Night
rock melodic fast solos

Rakesh Aur Priyanka
remix electronic

难以忘怀的分离
爱情、分离、伤感、温柔

Lost in Space
grindcore, jazz funk, classical

Acidcore music
ACIDCORE, male voice

Far Away Love
baritone male voice in the style of contemporary ballad with powerful, raspy voice and wide vocal range

Super Sonic
electroacoustic energetic catchy

Syntax Shenanigans
happy hardcore psytrance

Quê Hương Thân Thương
pop sentimental

Bold Head
crunk punk

Uwezo
contemporary congolese rhumba, groovy bass, solo and choir

Cosmic Rhythm
edm trance

The Lone Wanderer
acoustic guitar, piano

Simfonie simbiotică
Dembow Balkan Brass Band, Brutal Death Metal, Black Metal Grime, Rasta Phonk Drill, Classical Technical Prog Doom Metal

Валерия учит немецкий язык
Raplofi r&b slow

Apart Together
bossa nova opera pop animated korean japanese-pop
