commitfmt-linux 0.4.1__py3-none-any.whl → 1.0.0__py3-none-any.whl

{commitfmt_linux-0.4.1.dist-info → commitfmt_linux-1.0.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: commitfmt_linux
-Version: 0.4.1
+Version: 1.0.0
 Summary: Utility for formatting and verifying the commit message.
 Author-email: Mikhael Khrustik <misha@myrt.co>
 License: MIT
@@ -174,7 +174,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
@@ -233,26 +233,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`.
@@ -261,27 +272,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:
@@ -290,6 +301,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_linux-1.0.0.dist-info/RECORD

@@ -0,0 +1,5 @@
+commitfmt_linux/__init__.py,sha256=N5cpNKEYYrVRlEGVenMAfJyE80zm2znA33zwxjuo0e0,25
+commitfmt_linux-1.0.0.dist-info/METADATA,sha256=fe18ruwE2fevE7kmw3WYBGjXQ0TcLuEitlcpFMTpFhQ,9908
+commitfmt_linux-1.0.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+commitfmt_linux-1.0.0.dist-info/top_level.txt,sha256=KwB-TV2AfS1HLrHQ_it0d9NqEFJv8rKLW0B-x_vRFio,16
+commitfmt_linux-1.0.0.dist-info/RECORD,,

commitfmt_linux-0.4.1.dist-info/RECORD

@@ -1,5 +0,0 @@
-commitfmt_linux/__init__.py,sha256=N5cpNKEYYrVRlEGVenMAfJyE80zm2znA33zwxjuo0e0,25
-commitfmt_linux-0.4.1.dist-info/METADATA,sha256=1ZbTci8HwBeBj6-kV4c5Nf48vnDBizQJwFrjJvhrTsw,8955
-commitfmt_linux-0.4.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-commitfmt_linux-0.4.1.dist-info/top_level.txt,sha256=KwB-TV2AfS1HLrHQ_it0d9NqEFJv8rKLW0B-x_vRFio,16
-commitfmt_linux-0.4.1.dist-info/RECORD,,