documentation in mkdocs

README.md

@@ -13,6 +13,7 @@ Python library for generating Brazilian auxiliary fiscal documents in PDF from X
 - **DANFE** - Documento Auxiliar da Nota Fiscal Eletrônica (NF-e)
 - **DACCe** - Documento Auxiliar da Carta de Correção Eletrônica (CC-e)
 - **DACTE** - Documento Auxiliar do Conhecimento de Transporte Eletrônico (CT-e)
+- **DAMDFE** - Documento Auxiliar do Manifesto Eletrônico de Documentos Fiscais (MDF-e)
 
 ## Beta Stage Notice 🚧
 
@@ -40,6 +41,13 @@ If you specifically need the DACTE functionality, you can install it along with
 pip install brazilfiscalreport[dacte]
 ```
 
+### Installing CLI with Dependencies
+If you specifically need the CLI functionality, you can install it along with its required dependencies using:
+
+```bash
+pip install brazilfiscalreport[cli]
+```
+
 ## Credits 🙌
 This is a fork of the [nfe_utils](https://github.com/edsonbernar/nfe_utils) project, originally created by [Edson Bernardino](https://github.com/edsonbernar).
 

docs/about.md

@@ -0,0 +1,10 @@
+# About
+
+## Credits 🙌
+This is a fork of the [nfe_utils](https://github.com/edsonbernar/nfe_utils) project, originally created by [Edson Bernardino](https://github.com/edsonbernar).
+
+## Feedback and Support 📬
+For questions or support, feel free to open an issue or join the discussions in the repository.
+
+## Maintainer 🛠️
+[![Engenere](https://storage.googleapis.com/eng-imagens/logo-fundo-preto.webp)]([#](https://engenere.one/))

docs/cli.md

@@ -0,0 +1,19 @@
+
+Generate DACTE, DANFE, and DACCE documents directly from the terminal. The PDF will be saved in the current directory, and you'll need to create a config.yaml file with issuer details and other configurations.
+
+#### Example of `config.yaml` ⚙️
+
+```yaml
+ISSUER:
+  name: "EMPRESA LTDA"
+  address: "AV. TEST, 100"
+  city: "SÃO PAULO"
+  state: "SP"
+  phone: "(11) 1234-5678"
+
+LOGO: "/path/to/logo.jpg"
+TOP_MARGIN: 5.0
+RIGHT_MARGIN: 5.0
+BOTTOM_MARGIN: 5.0
+LEFT_MARGIN: 5.0
+```

docs/dacce.md

@@ -0,0 +1,26 @@
+DACCe (Auxiliary Document of the Electronic Bill of Lading) is a printed version of the Electronic Bill of Lading (BL-e) used in Brazil. It simplifies the information from the electronic document, providing details like sender, receiver, cargo, and transportation.
+
+## Using in Python Code 🐍
+
+```python
+from brazilfiscalreport.dacce import DaCCe
+
+# Path to the XML file
+xml_file_path = 'cce.xml'
+
+# Load XML Content
+with open(xml_file_path, "r", encoding="utf8") as file:
+    xml_content = file.read()
+
+# Instantiate the CC-e PDF object with the loaded XML content
+cce = DaCCe(xml=xml_content)
+
+# Save the generated PDF to a file
+cce.output('cce.pdf')
+```
+
+## Using in CLI 💻
+
+```
+bfrep dacce /path/to/cce_1.xml
+```

docs/dacte.md

@@ -0,0 +1,119 @@
+DACTE (Auxiliary Document of the Electronic Transportation Bill) is a printed document used in Brazil to accompany the electronic transportation invoice (CT-e). It serves as a simplified version of the CT-e, providing key details about the shipment, such as cargo information, sender and receiver, and transport company data.
+
+## Customizing DACTE 🎨
+
+This section describes how to customize the PDF output of the DACTE using the `DacteConfig` class. You can adjust various settings such as margins, fonts, and tax configurations according to your needs.
+
+## Using in Python Code 🐍
+
+```python
+from brazilfiscalreport.dacte import Dacte
+
+# Path to the XML file
+xml_file_path = 'cte.xml'
+
+# Load XML Content
+with open(xml_file_path, "r", encoding="utf8") as file:
+    xml_content = file.read()
+
+# Instantiate the DACTE object with the loaded XML content
+dacte = Dacte(xml=xml_content)
+dacte.output('output_dacte.pdf')
+```
+## Using in CLI 💻
+
+```
+bfrep dacte /path/to/dacte.xml
+```
+
+## Customizing DACTE 🎨
+
+This section describes how to customize the PDF output of the DACTE using the `DacteConfig` class. You can adjust various settings such as margins, fonts, and tax configurations according to your needs.
+
+### Configuration Options ⚙️
+
+Here is a breakdown of all the configuration options available in `DacteConfig`:
+
+---
+
+**Logo**
+
+- **Type**: `str`, `BytesIO`, or `bytes`
+- **Description**: Path to the logo file or binary image data to be included in the PDF. You can use a file path string or pass image data directly.
+- **Example**:
+    ```python
+    config.logo = "path/to/logo.jpg"  # Using a file path
+    ```
+- **Default**: No logo.
+
+---
+
+**Margins**
+
+- **Type**: `Margins`
+- **Fields**: `top`, `right`, `bottom`, `left` (all of type `Number`)
+- **Description**: Sets the page margins for the PDF document.
+- **Example**:
+    ```python
+    config.margins = Margins(top=5, right=5, bottom=5, left=5)
+    ```
+- **Default**: top, right, bottom, and left are set to 5 mm.
+
+---
+
+**Font Type**
+
+- **Type**: `FontType` (Enum)
+- **Values**: `COURIER`, `TIMES`
+- **Description**: Font style used throughout the PDF document.
+- **Example**:
+    ```python
+    config.font_type = FontType.COURIER
+    ```
+- **Default**: `TIMES`
+
+---
+
+**Display PIS COFINS**
+
+- **Type**: `Bool`
+- **Values**: `True`, `False`
+- **Description**: Whether or not to display PIS and COFINS taxes in the DACTE totals.
+- **Example**:
+    ```python
+    config.display_pis_cofins = True
+    ```
+- **Default**: `False`
+
+---
+
+### Usage Example with Customization
+
+Here’s how to set up a DacteConfig object with a full set of customizations:
+
+```python
+from brazilfiscalreport.dacte import (
+    Dacte,
+    DacteConfig,
+    FontType,
+    Margins,
+)
+
+# Path to the XML file
+xml_file_path = 'cte.xml'
+
+# Load XML Content
+with open(xml_file_path, "r", encoding="utf8") as file:
+    xml_content = file.read()
+
+# Create a configuration instance
+config = DacteConfig(
+    logo='path/to/logo.png',
+    margins=Margins(top=10, right=10, bottom=10, left=10),
+    font_type=FontType.TIMES
+)
+
+# Use this config when creating a Dacte instance
+dacte = Dacte(xml_content, config=config)
+dacte.output('output_dacte.pdf')
+```

docs/damdfe.md

@@ -0,0 +1,104 @@
+DAMDFE (Auxiliary Document of the Electronic Invoice for Retail) is a printed version of the Electronic Retail Invoice (NF-e) in Brazil. It contains key information about the transaction, such as the seller, buyer, and item details, and is used as proof of purchase.
+
+## Using in Python Code 🐍
+
+```python
+from brazilfiscalreport.damdfe import Damdfe
+
+# Path to the XML file
+xml_file_path = 'damdfe.xml'
+
+# Load XML Content
+with open(xml_file_path, "r", encoding="utf8") as file:
+    xml_content = file.read()
+
+# Instantiate the DAMDFE object with the loaded XML content
+damdfe = Damdfe(xml=xml_content)
+
+# Save the generated PDF to a file
+damdfe.output('damdfe.pdf')
+```
+
+## Using in CLI 💻
+
+```
+bfrep damdfe /path/to/cce_1.xml
+```
+## Customizing DAMDFE 🎨
+
+This section describes how to customize the PDF output of the DAMDFE using the `DamdfeConfig` class. You can adjust various settings such as margins, fonts, and tax configurations according to your needs.
+
+### Configuration Options ⚙️
+
+Here is a breakdown of all the configuration options available in `DamdfeConfig`:
+
+---
+
+**Logo**
+
+- **Type**: `str`, `BytesIO`, or `bytes`
+- **Description**: Path to the logo file or binary image data to be included in the PDF. You can use a file path string or pass image data directly.
+- **Example**:
+    ```python
+    config.logo = "path/to/logo.jpg"  # Using a file path
+    ```
+- **Default**: No logo.
+
+---
+
+**Margins**
+
+- **Type**: `Margins`
+- **Fields**: `top`, `right`, `bottom`, `left` (all of type `Number`)
+- **Description**: Sets the page margins for the PDF document.
+- **Example**:
+    ```python
+    config.margins = Margins(top=10, right=10, bottom=10, left=10)
+    ```
+- **Default**: top, right, bottom, and left are set to 5 mm.
+
+---
+
+**Font Type**
+
+- **Type**: `FontType` (Enum)
+- **Values**: `COURIER`, `TIMES`
+- **Description**: Font style used throughout the PDF document.
+- **Example**:
+    ```python
+    config.font_type = FontType.COURIER
+    ```
+- **Default**: `TIMES`
+
+---
+
+### Usage Example with Customization
+
+Here’s how to set up a DamdfeConfig object with a full set of customizations:
+
+```python
+from brazilfiscalreport.damdfe import (
+    Damdfe,
+    DacteConfig,
+    FontType,
+    Margins,
+)
+
+# Path to the XML file
+xml_file_path = 'mdf-e.xml'
+
+# Load XML Content
+with open(xml_file_path, "r", encoding="utf8") as file:
+    xml_content = file.read()
+
+# Create a configuration instance
+config = DamdfeConfig(
+    logo='path/to/logo.png',
+    margins=Margins(top=10, right=10, bottom=10, left=10),
+    font_type=FontType.TIMES
+)
+
+# Use this config when creating a Damdfe instance
+damdfe = Damdfe(xml_content, config=config)
+damdfe.output('output_dacte.pdf')
+```