Skip to content

Running the DOI Parser Python File

Jump to bottom
Peyton Tvrdy edited this page Feb 13, 2025 · 2 revisions

Running the Program

Running the DOI-Parser program is easy! Follow the instructions below to run the program.

Before Beginning the program, ensure you have:

  1. Installed the Required Libraries
  2. Have Navigated to the DOI-Parser Program File in Command Prompt
  3. Have placed your CSV/Copy of your CSV to the DOI-Parser program folder

Step 1: Run the DOI-Parser Program

After you have navigated to the DOI-Parser program folder in command prompt, run the following command to run the DOI-Parser program.

python [the name of the python file] [the name of the csv file]

For me this looks like:

python doi-parser.py DOI_Update_20240809.CSV

Step 2: Proceed through the Program

The DOI-Parser program has many prompts that will guide you through creating optimal metadata. Follow the prompts as they are given to you. Verify ROR Information as you proceed through the program. Type y or n for yes and no to various prompts. You can also type exit when prompted. After verifying ROR information for each Organization (Corporate Creator/Contributor/Publisher), the program will print the second row of your CSV/1st DOI data row. This is your opportunity to verify the data that you have in your CSV and ensure that the DOI-Parser program interpreted your headers correctly. If the data is incorrect and you need to make changes, when it asks if the information is correct, type 'n' to abort. If the data is correct, type y to save the JSON conversion of your CSV as a JSON file. The program will then ask if you wish to update the DOIs via the DataCite API. If you would like to, type 'y' for yes and the program will post/put each individual JSON DOI record to the DataCite API. If you type 'n' the program aborts.

Final Steps and Outputs

First, close the command prompt and open up your file directory to your DOI-Parser program folder. Back up all 4 files to a secure location. The files are:

  1. Your Original CSV file [base_file_name.csv]
  2. The JSON conversion of your CSV data + Each API response [base_file_name.json]
  3. The Log file of your interaction with the program [base_file_name.log]
  4. The CSV file of the DOIs you updated and their titles [base_file_name_doi_results.csv]

These files are important and track the DOI Updates/Reserves/Mints you created. The CSV file for DOI Results is especially helpful if you created reserves and you need to give those DOIs out.

Congratulations!

You are now done with your DOI work and the DOI-Parser program. Congratulations on successfully using the DOI-Parser program. It becomes easier with time, and soon you won't need the steps. Contact me for any questions or errors. If you run into an issue, raise an issue in the "Issues" tab. Happy DOI Updating!

Clone this wiki locally