Angel Oduro-Temeng Twumasi

Posted on Jul 16, 2023 • Edited on Apr 26

The Art of Clean Code: Mastering the Betty Style 🧑🏾‍💻

#c #programming #beginners #codenewbie

Introduction

When it comes to developing software in any programming language, adhering to a consistent coding style is crucial for maintaining readability, collaboration, and code quality. For the C programming language, one widely recognized coding style is known as Betty. Betty, originally created for the Linux kernel development, has become popular within the C programming community, providing a set of guidelines to enhance code clarity and maintainability.

What is Betty?

Betty is a coding style guide specifically tailored for the C programming language. It was devised to standardize coding practices within the Linux kernel development community, ensuring that the codebase is cohesive and comprehensible to developers working on the project.

The Importance of Consistent Style:

Consistency in coding style plays a vital role in collaborative projects, making it easier for team members to understand and modify each other's code. Betty enforces a standardized set of rules, including naming conventions, indentation, spacing, and comment placement. By following these guidelines, developers can produce clean, readable code that is more approachable to others and less prone to errors.

Set up betty on local machine.

Clone the betty repo
cd into the Betty directory
Install the linter with



sudo ./install.sh

Run the following commands to check if your code/doc fits the Betty Style:



betty-style <filename>



betty-doc <filename>

Let's look at a simple guide for coding using the Betty style

Indentation

Imagine looking at a codebase for more than 20hrs. Indentation helps you to easily identify which parts to find information quickly. This really helps with debugging

Use TAB to indent your code. A block of code is every group of statements inside a set of curly braces ({})

An example is what is used in our main function



int main(void)
{
        return (0);
}

Do not put multiple statements on a single line

This is a bad example



if (condition) do_this;
do_something_everytime;

This is a good example



if (condition)
     do_this;

do_something_everytime;

In the case of multiple indentation statements - the switch statement -, the switch keyword and it's subordinate case are placed on the same indentation levels as shown in the example below



int add(int sum)
{
        var i = 0;
        switch (sum)
        {
        case 23:
                i = 34;
        default:
                i = 4;
        }
        return var;
}

The use of braces {}

Opening and closing braces should be placed at the beginning of the next line. This is a bad example ```

if (condition) {
statement1;
statement2;
}

This a good example

if (condition)
{
statement1;
statement2;
}


This applies to functions as well. An example is the main function

int main(void)
{
return (0);
}

- The body of the braces should be indented as stated in the above examples.

There are exceptions to this rule however. If a continuation of the same statement follows the ending braces, you need to add it. An example is the `do....while` statement.

do {
body of loop;
} while (condition);

- Don't use braces for when a single statement is written in 
An example is the code below

if (condition)
statement;

It applies to this as well

if (condition)
statement;
else
statement;

Note that this doesn't apply where the even one has multiple statements. An example is

if (condition)
{
do_this();
do_this();
}
else
{
do_this();
}


- Don't use commas on a single line to avoid braces

if (condition)
do_this(), do_this();

Do this instead

if (condition) {
do_this();
do_this();
}


### Use of spaces
- Use space after these keywords `if`, `else if`, `switch`, `case`, `for`, `while`, `return`.
- Do not use space however after the following which look like functions: `sizeof`, `typeof`, `alignof` and `__attribute__`.

Here's a table for reference


![Image description](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/xj08kns1wwrp7mldlb07.png)

However, do not use spaces around (inside) expressions.
This is a bad example

a = sizeof( struct file );

This is a good example

a = sizeof(struct file);


- Use one space around most binary and ternary operators such as :

= + - < > * / % | & ^ <= >= == != ? :

- Do not use spaces around **_unary operators_** :

& * + ~ ! sizeof typeof alignof attribute defined


- Do not leave trailing whitespace at the end of lines else you'll receive the following warning from betty


![Image description](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/smy3rpnsw2cpxm573xut.png)

### Breaking of long lines of character
Coding is all about readability and maintainability. Lines of code should not be very long such that one needs to scroll laterally to read them.
The limit on the lines is **80 columns** and is strongly the preferred limit

### Functions
Functions are simply a chunk of code that does one particular thing.
- Functions must contain not more than **40 lines of code**
- Local variables in a function shouldn't exceed `5-10`
- When using source file, **separate functions with one blank line**

### Commenting in C

/* This is a single line comment */

/**

This is a multiline comment
comments in C source code */


## Code Documentation
The use of documentation in programming is very necessary for anyone to be able to understand the code very well. We provide documentation by way of commenting. By adding comments at key points, you provide context, explanations, and insights that clarify your code's purpose, intentions and intricacies.

Betty has a style for documenting your code. Let's look at them

### How to document functions
Instead of a regular C multiline commenting, the comment block for the documentation would look like this.

/**

main - This is the entry point of the code *
Return - 0 Successful */

int main(void)
{
printf("Hello");
return (0);
}


- If the function must return a value, the `Return:` header tag is **mandatory**

- Arguments supplied to functions must be added to their respective tags.

/**

sum - Calucates the sum of two numbers
@arg1 - First operand
@arg2 - Second operand *
Return: The sum of the two parameters */


- You could add additional sections like `Example` which you could give examples of the usage of your function

/**

Sum- Makes the sum of two numbers
@arg1: First operand
@arg2: Second operand *
Return: The sum of two parameters *
Example:
sum(10, 5); --> 15 */

int sum(int num1, int num2)
{
return (num1 + num2);
}


Using the Betty Coding style is extremely beneficial as a programmer. It ensures that your codes are consistent, readable and have great clarity.

I believe this was a great read for you especially if you are a C programmer and a student of ALX Software Engineering and Holberton School. Like and comment if you found it helpful.

Read more about the style of coding from the [Linux Kernel coding style](https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git/plain/Documentation/process/coding-style.rst)

Follow me on [Github](https://www.github.com/angelotheman), let's get interractive on [Twitter](https://www.twitter.com/_angelotheman) and form great connections on [LinkedIn](https://www.linkedin.com/in/angelotheman) 😊