commitfmt 0.4.1__tar.gz → 1.0.1__tar.gz

{commitfmt-0.4.1 → commitfmt-1.0.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: commitfmt
-Version: 0.4.1
+Version: 1.0.1
 Summary: Utility for formatting and verifying the commit message.
 Author-email: Mikhael Khrustik <misha@myrt.co>
 License: MIT
@@ -178,7 +178,7 @@ Most of the linting rules are disabled by default. Default config contains 2 rul
 
 ```toml
 [lint.header]
-full-stop = true
+description-full-stop = true
 
 [lint.footer]
 breaking-exclamation = true
@@ -237,26 +237,37 @@ Lines starting with the comment symbol will be ignored during parsing.
 
 commitfmt can add additional footers to the commit message.
 
-#### Value template
+#### Static value
 
-You can use a template to format the value of the footer. Inside of template expression you can use any shell command available at the `PATH`.
+You can add a footer with a static value:
 
-For example, to add the `Authored-By` footer with the current user name, add the following to your config file:
+```toml
+[[additional-footers]]
+key = "Authored-By"
+value = "John Doe"
+```
+
+#### Shell commands
+
+You can use shell commands to dynamically generate footer values:
 
 ```toml
-[additional-footers]
+[[additional-footers]]
 key = "Authored-By"
-value-template = "{{ echo $USER }}"
+value = "{{ echo $USER }}"
 ```
 
+Inside the template expression you can use any shell command available in the `PATH`.
+
 #### Branch value pattern
 
 You can also add the ticket number from the task tracker to the footer if it is in the branch name:
 
 ```toml
-[additional-footers]
+[[additional-footers]]
 key = "Ticket-ID"
-branch-value-pattern = "(?:.*)/([A-Z0-9-]+)/?(?:.*)"
+branch-pattern = "(?:.*)/(?<TICKET_ID>[A-Z0-9-]+)/?(?:.*)"
+value = "${{ TICKET_ID }}"
 ```
 
 For example, if your branch name is `feature/CC-123/add-new-feature` or `feature/CC-123`, the `Ticket-ID` footer will be added to the commit message with the value `CC-123`.
@@ -265,27 +276,27 @@ If the ticket number is not found in the branch name, footer will be skipped.
 
 You can use [rustexp](https://rustexp.lpil.uk) to test your pattern.
 
-##### Recipes
+##### Patterns
 
 Examples of patterns for branch names in git flow format:
 
-- Jira/YouTrack: `(?:.*)/([A-Z0-9-]+)/?(?:.*)`
+- Jira/YouTrack: `(?:.*)/(?<TICKET_ID>[A-Z0-9-]+)/?(?:.*)`
   - `feature/CFMT-123`
   - `feature/CFMT-123/add-new-feature`
-- GitHub: `(?:.*)/#?([0-9-]+)/?(?:.*)`
-  - `feature/#123`
+- GitHub: `(?:.*)/(?<ISSUE_ID>[0-9-]+)/?(?:.*)`
   - `feature/123`
-  - `feature/#123/add-new-feature`
+  - `feature/123/add-new-feature`
 
 #### On conflict
 
 If the footer already exists in the commit message, you can specify what to do with it. By default, the footer will be skipped.
 
 ```toml
-[additional-footers]
+[[additional-footers]]
 key = "Ticket-ID"
-branch-value-pattern = "(?:.*)/([A-Z0-9-]+)/?(?:.*)"
-on-conflict = "skip" # skip, append, error
+branch-pattern = "(?:.*)/(?<TICKET_ID>[A-Z0-9-]+)/?(?:.*)"
+value = "${{ TICKET_ID }}"
+on-conflict = "error" # optional. default: skip. available: skip, append, error
 ```
 
 Available options:
@@ -294,6 +305,44 @@ Available options:
 - `append` - append the footer to the end of the footer list
 - `error` - abort the commit
 
+#### Footer formatting
+
+You can customize how footers are formatted using `separator` and `alignment` options:
+
+```toml
+[[additional-footers]]
+key = "Ticket-ID"
+value = "CFMT-123"
+separator = "#"
+alignment = "right"
+```
+
+Available alignment options:
+
+- `left` - align separator to the left (default)
+- `right` - align separator to the right
+
+### Recipe
+
+To enforce conventional commits, you can use the following configuration:
+
+```toml
+[lint.header]
+type-enum = ["chore", "ci", "feat", "fix", "refactor", "style", "test", "docs"]
+description-case = "lower-first"
+description-max-length = 72
+description-full-stop = true
+type-required = true
+# scope-enum = ["cc", "config", "git", "linter"] # optional
+
+[lint.body]
+max-line-length = 72
+case = "upper-first"
+
+[lint.footer]
+breaking-exclamation = true
+```
+
 ## Testing
 
 To test the configuration and the work of commitfmt, run the following command:

{commitfmt-0.4.1 → commitfmt-1.0.1}/README.md

@@ -155,7 +155,7 @@ Most of the linting rules are disabled by default. Default config contains 2 rul
 
 ```toml
 [lint.header]
-full-stop = true
+description-full-stop = true
 
 [lint.footer]
 breaking-exclamation = true
@@ -214,26 +214,37 @@ Lines starting with the comment symbol will be ignored during parsing.
 
 commitfmt can add additional footers to the commit message.
 
-#### Value template
+#### Static value
 
-You can use a template to format the value of the footer. Inside of template expression you can use any shell command available at the `PATH`.
+You can add a footer with a static value:
 
-For example, to add the `Authored-By` footer with the current user name, add the following to your config file:
+```toml
+[[additional-footers]]
+key = "Authored-By"
+value = "John Doe"
+```
+
+#### Shell commands
+
+You can use shell commands to dynamically generate footer values:
 
 ```toml
-[additional-footers]
+[[additional-footers]]
 key = "Authored-By"
-value-template = "{{ echo $USER }}"
+value = "{{ echo $USER }}"
 ```
 
+Inside the template expression you can use any shell command available in the `PATH`.
+
 #### Branch value pattern
 
 You can also add the ticket number from the task tracker to the footer if it is in the branch name:
 
 ```toml
-[additional-footers]
+[[additional-footers]]
 key = "Ticket-ID"
-branch-value-pattern = "(?:.*)/([A-Z0-9-]+)/?(?:.*)"
+branch-pattern = "(?:.*)/(?<TICKET_ID>[A-Z0-9-]+)/?(?:.*)"
+value = "${{ TICKET_ID }}"
 ```
 
 For example, if your branch name is `feature/CC-123/add-new-feature` or `feature/CC-123`, the `Ticket-ID` footer will be added to the commit message with the value `CC-123`.
@@ -242,27 +253,27 @@ If the ticket number is not found in the branch name, footer will be skipped.
 
 You can use [rustexp](https://rustexp.lpil.uk) to test your pattern.
 
-##### Recipes
+##### Patterns
 
 Examples of patterns for branch names in git flow format:
 
-- Jira/YouTrack: `(?:.*)/([A-Z0-9-]+)/?(?:.*)`
+- Jira/YouTrack: `(?:.*)/(?<TICKET_ID>[A-Z0-9-]+)/?(?:.*)`
   - `feature/CFMT-123`
   - `feature/CFMT-123/add-new-feature`
-- GitHub: `(?:.*)/#?([0-9-]+)/?(?:.*)`
-  - `feature/#123`
+- GitHub: `(?:.*)/(?<ISSUE_ID>[0-9-]+)/?(?:.*)`
   - `feature/123`
-  - `feature/#123/add-new-feature`
+  - `feature/123/add-new-feature`
 
 #### On conflict
 
 If the footer already exists in the commit message, you can specify what to do with it. By default, the footer will be skipped.
 
 ```toml
-[additional-footers]
+[[additional-footers]]
 key = "Ticket-ID"
-branch-value-pattern = "(?:.*)/([A-Z0-9-]+)/?(?:.*)"
-on-conflict = "skip" # skip, append, error
+branch-pattern = "(?:.*)/(?<TICKET_ID>[A-Z0-9-]+)/?(?:.*)"
+value = "${{ TICKET_ID }}"
+on-conflict = "error" # optional. default: skip. available: skip, append, error
 ```
 
 Available options:
@@ -271,6 +282,44 @@ Available options:
 - `append` - append the footer to the end of the footer list
 - `error` - abort the commit
 
+#### Footer formatting
+
+You can customize how footers are formatted using `separator` and `alignment` options:
+
+```toml
+[[additional-footers]]
+key = "Ticket-ID"
+value = "CFMT-123"
+separator = "#"
+alignment = "right"
+```
+
+Available alignment options:
+
+- `left` - align separator to the left (default)
+- `right` - align separator to the right
+
+### Recipe
+
+To enforce conventional commits, you can use the following configuration:
+
+```toml
+[lint.header]
+type-enum = ["chore", "ci", "feat", "fix", "refactor", "style", "test", "docs"]
+description-case = "lower-first"
+description-max-length = 72
+description-full-stop = true
+type-required = true
+# scope-enum = ["cc", "config", "git", "linter"] # optional
+
+[lint.body]
+max-line-length = 72
+case = "upper-first"
+
+[lint.footer]
+breaking-exclamation = true
+```
+
 ## Testing
 
 To test the configuration and the work of commitfmt, run the following command:

{commitfmt-0.4.1 → commitfmt-1.0.1}/commitfmt.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: commitfmt
-Version: 0.4.1
+Version: 1.0.1
 Summary: Utility for formatting and verifying the commit message.
 Author-email: Mikhael Khrustik <misha@myrt.co>
 License: MIT
@@ -178,7 +178,7 @@ Most of the linting rules are disabled by default. Default config contains 2 rul
 
 ```toml
 [lint.header]
-full-stop = true
+description-full-stop = true
 
 [lint.footer]
 breaking-exclamation = true
@@ -237,26 +237,37 @@ Lines starting with the comment symbol will be ignored during parsing.
 
 commitfmt can add additional footers to the commit message.
 
-#### Value template
+#### Static value
 
-You can use a template to format the value of the footer. Inside of template expression you can use any shell command available at the `PATH`.
+You can add a footer with a static value:
 
-For example, to add the `Authored-By` footer with the current user name, add the following to your config file:
+```toml
+[[additional-footers]]
+key = "Authored-By"
+value = "John Doe"
+```
+
+#### Shell commands
+
+You can use shell commands to dynamically generate footer values:
 
 ```toml
-[additional-footers]
+[[additional-footers]]
 key = "Authored-By"
-value-template = "{{ echo $USER }}"
+value = "{{ echo $USER }}"
 ```
 
+Inside the template expression you can use any shell command available in the `PATH`.
+
 #### Branch value pattern
 
 You can also add the ticket number from the task tracker to the footer if it is in the branch name:
 
 ```toml
-[additional-footers]
+[[additional-footers]]
 key = "Ticket-ID"
-branch-value-pattern = "(?:.*)/([A-Z0-9-]+)/?(?:.*)"
+branch-pattern = "(?:.*)/(?<TICKET_ID>[A-Z0-9-]+)/?(?:.*)"
+value = "${{ TICKET_ID }}"
 ```
 
 For example, if your branch name is `feature/CC-123/add-new-feature` or `feature/CC-123`, the `Ticket-ID` footer will be added to the commit message with the value `CC-123`.
@@ -265,27 +276,27 @@ If the ticket number is not found in the branch name, footer will be skipped.
 
 You can use [rustexp](https://rustexp.lpil.uk) to test your pattern.
 
-##### Recipes
+##### Patterns
 
 Examples of patterns for branch names in git flow format:
 
-- Jira/YouTrack: `(?:.*)/([A-Z0-9-]+)/?(?:.*)`
+- Jira/YouTrack: `(?:.*)/(?<TICKET_ID>[A-Z0-9-]+)/?(?:.*)`
   - `feature/CFMT-123`
   - `feature/CFMT-123/add-new-feature`
-- GitHub: `(?:.*)/#?([0-9-]+)/?(?:.*)`
-  - `feature/#123`
+- GitHub: `(?:.*)/(?<ISSUE_ID>[0-9-]+)/?(?:.*)`
   - `feature/123`
-  - `feature/#123/add-new-feature`
+  - `feature/123/add-new-feature`
 
 #### On conflict
 
 If the footer already exists in the commit message, you can specify what to do with it. By default, the footer will be skipped.
 
 ```toml
-[additional-footers]
+[[additional-footers]]
 key = "Ticket-ID"
-branch-value-pattern = "(?:.*)/([A-Z0-9-]+)/?(?:.*)"
-on-conflict = "skip" # skip, append, error
+branch-pattern = "(?:.*)/(?<TICKET_ID>[A-Z0-9-]+)/?(?:.*)"
+value = "${{ TICKET_ID }}"
+on-conflict = "error" # optional. default: skip. available: skip, append, error
 ```
 
 Available options:
@@ -294,6 +305,44 @@ Available options:
 - `append` - append the footer to the end of the footer list
 - `error` - abort the commit
 
+#### Footer formatting
+
+You can customize how footers are formatted using `separator` and `alignment` options:
+
+```toml
+[[additional-footers]]
+key = "Ticket-ID"
+value = "CFMT-123"
+separator = "#"
+alignment = "right"
+```
+
+Available alignment options:
+
+- `left` - align separator to the left (default)
+- `right` - align separator to the right
+
+### Recipe
+
+To enforce conventional commits, you can use the following configuration:
+
+```toml
+[lint.header]
+type-enum = ["chore", "ci", "feat", "fix", "refactor", "style", "test", "docs"]
+description-case = "lower-first"
+description-max-length = 72
+description-full-stop = true
+type-required = true
+# scope-enum = ["cc", "config", "git", "linter"] # optional
+
+[lint.body]
+max-line-length = 72
+case = "upper-first"
+
+[lint.footer]
+breaking-exclamation = true
+```
+
 ## Testing
 
 To test the configuration and the work of commitfmt, run the following command:

{commitfmt-0.4.1 → commitfmt-1.0.1}/pyproject.toml

@@ -4,7 +4,7 @@ authors = [
     {name = "Mikhael Khrustik", email = "misha@myrt.co"},
 ]
 description = "Utility for formatting and verifying the commit message."
-version = "0.4.1"
+version = "1.0.1"
 readme = "README.md"
 requires-python = ">=3.9"
 keywords = ["git", "hook"]