A mild-mannered reporter with hidden superpowers for your data science projects.
Version 1.0.0
Created by Graham Waters
- The Clark Kent Reporter
- Table of Contents
- Automatic Report Generation with Clark Kent Reporter
- What does The Clark Kent Reporter do?
- How to Get Clark Running
- Installation
- Contributing
- Example Use Case
- License
- Acknowledgments
Latest Version: 1.0.0
Created by Graham Waters
This tool converts a traditionally formatted overview (in a readme file) into a populated Jupyter Notebook for data science presentations or findings presentations. It doesn't magically transform your work from a document to a presentation, which will still require the careful work that data scientists and analysts are known for. However, it does make sure you don't have to start from scratch when making an interactive and working notebook out of something that would otherwise take hours manually write everything out again. I realized how many readmes I would be reading if I did it the old-fashioned way.
We recommend using a virtual environment for this. Don't worry if you've never done that before. We did all the heavy lifting for you by including the code here below. Just copy and paste!
conda create --name clark_kent_reporter python=3.9.6
Now that you have your virtual environment set up, you need to activate it. This is done by running the following command:
conda activate clark_kent_reporter
Then install the requirements:
pip3 install -r requirements.txt
You should be good to go!
Until we are listed on PyPi you can clone the repo and install locally. I will update this section once we are listed on PyPi.
If you would like to contribute to this project, please feel free to fork the repository and submit a pull request. I will review the pull request as soon as I can. We welcome any and all contributions as this is a growing tool.
Let's say I have a project that generates lorebooks for NovelAI project I can use this this tool to generate my overview notebook for the project as follows:
- The readme file for NovelAI Lorebook Generator
README.md
. - The
MOCKUP_README.md
file in theroot
directory of this repository.
- Open the readme file in a text editor and copy the text.
- Then I paste the text into the
MOCKUP_README.md
file in theroot
directory of this repository. - Then I open Clark Kent Reporter in Visual Studio Code and run the script.
- The
destination
andsource
files are set in themain.py
file. You can change them to whatever you want. - The script will generate a notebook file in the
destination
directory. In this case, it will be in thenotebooks
directory. The file will be namedgenerated_notebook.ipynb
. If this is not the case for you, please open an issue and I will look into it.
This project is licensed under the MIT License - see the LICENSE.md
file for details
I would like to thank the following people for their support and guidance:
- Superman - for being the inspiration for this project.
- Clark Kent, who is clearly not superman. Because he is just a mild mannered reporter.