Exercises - Protein Translation - Patch 1 (to clarify biological terminology) (#1048)

* Update protein_translation.h to clarify terminology

Renamed typedef statements to better reflect biological terminology: Methionine, Serine, etc. are examples of amino acids, and a protein is a sequence of several amino acids. A single RNA strand corresponds to one protein, not several.

* Update test_protein_translation.c to clarify terminology

proteins_t => protein_t
A single RNA strand corresponds to a single protein.

* Update example.h to clarify terminology

Renamed typedef statements to better reflect biological terminology: Methionine, Serine, etc. are examples of amino acids, and a protein is a sequence of several amino acids. A single RNA strand corresponds to one protein, not several.

* Update example.c to reflect clarified terminology

Renamed some variables and type definitions to match biological terminology: one codon corresponds to one amino acid, and one RNA sequence of several amino acids corresponds to one protein.

* Apply suggested fixes

---------

Co-authored-by: Ryan Hartlage <ryanplusplus@gmail.com>

Author: pozdniakovda

exercises/practice/protein-translation/.meta/example.c

@@ -5,11 +5,11 @@ enum { codon_length = 3 };
 
 typedef struct {
    const char *const codon;
-   protein_t protein;
+   amino_acid_t amino_acid;
    bool stop;
-} protein_translation_t;
+} amino_acid_translation_t;
 
-static const protein_translation_t translations[] = {
+static const amino_acid_translation_t translations[] = {
    { "AUG", Methionine, false },
    { "UUU", Phenylalanine, false },
    { "UUC", Phenylalanine, false },
@@ -31,9 +31,9 @@ static const protein_translation_t translations[] = {
 static const size_t translation_count =
     sizeof(translations) / sizeof(translations[0]);
 
-proteins_t proteins(const char *const rna)
+protein_t protein(const char *const rna)
 {
-   proteins_t proteins = { .valid = true, .count = 0 };
+   protein_t protein = { .valid = true, .count = 0 };
 
    size_t rna_length = strlen(rna);
 
@@ -43,20 +43,21 @@ proteins_t proteins(const char *const rna)
       for (size_t j = 0; j < translation_count; j++) {
          if (strncmp(rna + i, translations[j].codon, codon_length) == 0) {
             if (translations[j].stop) {
-               return proteins;
+               return protein;
             } else {
-               proteins.proteins[proteins.count++] = translations[j].protein;
+               protein.amino_acids[protein.count++] =
+                   translations[j].amino_acid;
                found_codon = true;
                break;
             }
          }
       }
 
       if (!found_codon) {
-         proteins.valid = false;
-         return proteins;
+         protein.valid = false;
+         return protein;
       }
    }
 
-   return proteins;
+   return protein;
 }

exercises/practice/protein-translation/.meta/example.h

@@ -4,7 +4,7 @@
 #include <stdbool.h>
 #include <stddef.h>
 
-#define MAX_PROTEINS 10
+#define MAX_AMINO_ACIDS 10
 
 typedef enum {
    Methionine,
@@ -14,14 +14,14 @@ typedef enum {
    Tyrosine,
    Cysteine,
    Tryptophan,
-} protein_t;
+} amino_acid_t;
 
 typedef struct {
    bool valid;
    size_t count;
-   protein_t proteins[MAX_PROTEINS];
-} proteins_t;
+   amino_acid_t amino_acids[MAX_AMINO_ACIDS];
+} protein_t;
 
-proteins_t proteins(const char *const rna);
+protein_t protein(const char *const rna);
 
 #endif

exercises/practice/protein-translation/protein_translation.h

@@ -4,7 +4,7 @@
 #include <stdbool.h>
 #include <stddef.h>
 
-#define MAX_PROTEINS 10
+#define MAX_AMINO_ACIDS 10
 
 typedef enum {
    Methionine,
@@ -14,14 +14,14 @@ typedef enum {
    Tyrosine,
    Cysteine,
    Tryptophan,
-} protein_t;
+} amino_acid_t;
 
 typedef struct {
    bool valid;
    size_t count;
-   protein_t proteins[MAX_PROTEINS];
-} proteins_t;
+   amino_acid_t amino_acids[MAX_AMINO_ACIDS];
+} protein_t;
 
-proteins_t proteins(const char *const rna);
+protein_t protein(const char *const rna);
 
 #endif