# Invoice PDF Generator
[](https://github.com/emads22/invoice-pdfgen-python/blob/main/LICENSE)
The Invoice PDF Generator is a Python package designed to simplify the process of creating PDF invoices from Excel invoice data. With this package, you can quickly generate professional-looking invoices for your business needs.
## Features
- **Easy to Use**: Generate PDF invoices with just a few lines of Python code.
- **Customizable**: Customize the appearance of your invoices by specifying fonts, colors, and layouts.
- **Excel Integration**: Read invoice data directly from Excel files, making it easy to manage and update invoice information.
- **Total Amount Calculation**: Automatically calculate the total amount due based on the invoice data.
- **Logo Support**: Add your company logo to the invoice for branding purposes.
- **Cross-Platform**: Works seamlessly on Windows, macOS, and Linux.
## Installation
You can install the Invoice PDF Generator package via pip:
```bash
pip install invoice_pdfgen
```
## Usage
To use the Invoice PDF Generator package, follow these steps:
1. Import the `PDFInvoiceGenerator` class from the package.
2. Create an instance of the `PDFInvoiceGenerator` class, providing the paths to the Excel invoice file and the company logo.
3. Generate the PDF invoice using the `generate()` method.
```python
from invoice_pdfgen import PDFInvoiceGenerator
# Create an instance of PDFInvoiceGenerator
generator = PDFInvoiceGenerator(excel_filepath='invoice_data.xlsx', logo_filepath='company_logo.png')
# Generate the PDF invoice
generator.generate()
```
## Documentation
For more detailed documentation, including API references and usage examples, please visit the [documentation](https://github.com/emads22/invoice-pdfgen-python/blob/main/docs/index.md).
## Author
- Emad E>
[<img src="https://img.shields.io/badge/GitHub-Profile-blue?logo=github" width="150">](https://github.com/emads22)
## License
This project is licensed under the **MIT License**, which grants permission for free use, modification, distribution, and sublicense of the code, provided that the copyright notice (attributed to [emads22](https://github.com/emads22)) and permission notice are included in all copies or substantial portions of the software. This license is permissive and allows users to utilize the code for both commercial and non-commercial purposes.
Please see the [LICENSE](https://github.com/emads22/invoice-pdfgen-python/blob/main/LICENSE) file for more details.
Raw data
{
"_id": null,
"home_page": "https://github.com/emads22/invoice-pdfgen-python",
"name": "invoice-pdfgen",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": "invoice, excel, pdf",
"author": "emads22",
"author_email": "emads@email.com",
"download_url": "https://files.pythonhosted.org/packages/4d/1f/444ec5ddf0ebfcc0cb9e19eda96801a58b1cd308a263eaa2b9464ff44d64/invoice_pdfgen-1.2.0.tar.gz",
"platform": null,
"description": "# Invoice PDF Generator\r\n\r\n[](https://github.com/emads22/invoice-pdfgen-python/blob/main/LICENSE)\r\n\r\nThe Invoice PDF Generator is a Python package designed to simplify the process of creating PDF invoices from Excel invoice data. With this package, you can quickly generate professional-looking invoices for your business needs.\r\n\r\n## Features\r\n\r\n- **Easy to Use**: Generate PDF invoices with just a few lines of Python code.\r\n- **Customizable**: Customize the appearance of your invoices by specifying fonts, colors, and layouts.\r\n- **Excel Integration**: Read invoice data directly from Excel files, making it easy to manage and update invoice information.\r\n- **Total Amount Calculation**: Automatically calculate the total amount due based on the invoice data.\r\n- **Logo Support**: Add your company logo to the invoice for branding purposes.\r\n- **Cross-Platform**: Works seamlessly on Windows, macOS, and Linux.\r\n\r\n## Installation\r\n\r\nYou can install the Invoice PDF Generator package via pip:\r\n\r\n```bash\r\npip install invoice_pdfgen\r\n```\r\n\r\n## Usage\r\n\r\nTo use the Invoice PDF Generator package, follow these steps:\r\n\r\n1. Import the `PDFInvoiceGenerator` class from the package.\r\n2. Create an instance of the `PDFInvoiceGenerator` class, providing the paths to the Excel invoice file and the company logo.\r\n3. Generate the PDF invoice using the `generate()` method.\r\n\r\n```python\r\nfrom invoice_pdfgen import PDFInvoiceGenerator\r\n\r\n# Create an instance of PDFInvoiceGenerator\r\ngenerator = PDFInvoiceGenerator(excel_filepath='invoice_data.xlsx', logo_filepath='company_logo.png')\r\n\r\n# Generate the PDF invoice\r\ngenerator.generate()\r\n```\r\n\r\n## Documentation\r\n\r\nFor more detailed documentation, including API references and usage examples, please visit the [documentation](https://github.com/emads22/invoice-pdfgen-python/blob/main/docs/index.md).\r\n\r\n## Author\r\n- Emad E>\r\n \r\n [<img src=\"https://img.shields.io/badge/GitHub-Profile-blue?logo=github\" width=\"150\">](https://github.com/emads22)\r\n\r\n## License\r\nThis project is licensed under the **MIT License**, which grants permission for free use, modification, distribution, and sublicense of the code, provided that the copyright notice (attributed to [emads22](https://github.com/emads22)) and permission notice are included in all copies or substantial portions of the software. This license is permissive and allows users to utilize the code for both commercial and non-commercial purposes.\r\n\r\nPlease see the [LICENSE](https://github.com/emads22/invoice-pdfgen-python/blob/main/LICENSE) file for more details.\r\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "This package can be used for generating PDF invoices from Excel invoices.",
"version": "1.2.0",
"project_urls": {
"Homepage": "https://github.com/emads22/invoice-pdfgen-python"
},
"split_keywords": [
"invoice",
" excel",
" pdf"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "5e0efed11f0f7469ca32edec1ba5075b22a970b159366399ba964e319de4c655",
"md5": "60d3a576859217320ff470f79e92b94f",
"sha256": "42721d23a229da9b22df292719f2dd9b055f729a1e04d970fac3946c4fae138d"
},
"downloads": -1,
"filename": "invoice_pdfgen-1.2.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "60d3a576859217320ff470f79e92b94f",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 5315,
"upload_time": "2024-05-03T15:22:13",
"upload_time_iso_8601": "2024-05-03T15:22:13.291925Z",
"url": "https://files.pythonhosted.org/packages/5e/0e/fed11f0f7469ca32edec1ba5075b22a970b159366399ba964e319de4c655/invoice_pdfgen-1.2.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "4d1f444ec5ddf0ebfcc0cb9e19eda96801a58b1cd308a263eaa2b9464ff44d64",
"md5": "583c6a346c385f84c649e0f92264f2f9",
"sha256": "0d21f572897262715532683c2f0826e5d6b7366fc67d95b87ae8cfafdac18efd"
},
"downloads": -1,
"filename": "invoice_pdfgen-1.2.0.tar.gz",
"has_sig": false,
"md5_digest": "583c6a346c385f84c649e0f92264f2f9",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 5350,
"upload_time": "2024-05-03T15:22:15",
"upload_time_iso_8601": "2024-05-03T15:22:15.126438Z",
"url": "https://files.pythonhosted.org/packages/4d/1f/444ec5ddf0ebfcc0cb9e19eda96801a58b1cd308a263eaa2b9464ff44d64/invoice_pdfgen-1.2.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-05-03 15:22:15",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "emads22",
"github_project": "invoice-pdfgen-python",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"requirements": [
{
"name": "fpdf",
"specs": [
[
"==",
"1.7.2"
]
]
},
{
"name": "openpyxl",
"specs": [
[
"==",
"3.1.2"
]
]
},
{
"name": "pandas",
"specs": [
[
"==",
"2.2.2"
]
]
}
],
"lcname": "invoice-pdfgen"
}
JSON
