Credito is a program to make instant credits in any Python app.

pip install credito

License

This project is licensed under the GNU General Public License v3.0 (GPLv3). See LICENSE for details.

Documentation

Install with:

pip3 install credito pip install credito

Configure and Use credito:

1. Import and Configure the Module:

You can import credito from the credito package and configure it with the path to your custom credits.cfg file. If you don’t specify a path, the default credits.cfg file included in the package will be used.

from credito import Credito

# Create an instance of Credito
credito = Credito()

# If you put nothing in the brackets then it will
# automatically use the default credits.cfg file included in the package.
credito.config()
# Or,
# Configure with a custom credits.cfg file
credito.config('path/to/your/custom/credits.cfg')

2. Start the Handler:

To start listening for the key combination (CTRL + O) and display the credits, you can call the handler function.

credito.handler()

3. Run the Module:

To have credito run in the background and listen for the key combination, you can run it as a standalone script or integrate it into your application.

If running as a standalone script, you can simply execute:

python -m credito

Or, integrate it into your application by calling the handler function as shown above.

How the Printing Works:

1. Configuration (credito.config):

• When you call credito.config("path/to/custom/credits.cfg"), it loads the content of the credits.cfg file into memory by reading it and storing the content in the self.credits variable.
• If you don't pass a path to the config function, it will use the default credits.cfg file included in the package.

2. Keypress Handler(handler):

• When the CTRL + O key combination is detected by the listen_for_keypress function, it triggers the handler() function. The handler() function, in turn, calls credito.show_credits().

3. Displaying Credits (show_credits):

• Inside show_credits(), the console is cleared using os.system('cls' if os.name == 'nt' else 'clear'), and then the content of self.credits (which contains the content from credits.cfg) is printed.
• The program pauses for 10 seconds (time.sleep(10)), allowing the user to see the credits, and then it optionally clears the screen again.

Thank you for using our application!

Credits:
- Developer: Your Name
- Support: support@example.com

Enjoy using our software!

Directory Structure:

credito/ - # Base directory
├── credito/ - # Main package folder
│   ├── __init__.py - # Initializes the package
│   ├── credito.py - # Contains the Credito class and logic
│   └── data/ - # Contains seperate info
│       └── credits.cfg - # Default credits file 
├── tests/ - # Tests folder
│   ├── __init__.py - # Can be empty or contain shared fixtures
│   ├── conftest.py - # Global fixtures and hooks for tests
│   ├── test_credito.py - # Unit tests for Credito class
├── README.md - # Project description
├── setup.py - # Setup script for packaging
└── LICENSE - # Obviously just a license

âš¡ Quote
"Talk is cheap. Show me the code."
-- Linus Torvalds --