github.com/letsencrypt/boulder@v0.20251208.0/linter/lints/test/README.md (about)

     1  # Test Lint CRLs
     2  
     3  The contents of this directory are a variety of PEM-encoded CRLs uses to test
     4  the CRL linting functions in the parent directory.
     5  
     6  To create a new test CRL to exercise a new lint:
     7  
     8  1. Install the `der2text` and `text2der` tools:
     9  
    10     ```sh
    11     $ go install github.com/syncsynchalt/der2text/cmds/text2der@latest
    12     $ go install github.com/syncsynchalt/der2text/cmds/der2text@latest
    13     ```
    14  
    15  2. Use `der2text` to create an editable version of CRL you want to start with, usually `crl_good.pem`:
    16    
    17     ```sh
    18     $ der2text crl_good.pem > my_new_crl.txt
    19     ```
    20  
    21  3. Edit the text file. See [the der2text readme](https://github.com/syncsynchalt/der2text) for details about the file format.
    22  
    23  4. Write the new PEM file and run the tests to see if it works! Repeat steps 3 and 4 as necessary until you get the correct result.
    24  
    25     ```sh
    26     $ text2der my_new_crl.txt >| my_new_crl.pem
    27     $ go test ..
    28     ```
    29  
    30  5. Remove the text file and commit your new CRL.
    31  
    32     ```sh
    33     $ rm my_new_crl.txt
    34     $ git add .
    35     ```