Skip to content

Commit

Permalink
Format markdown
Browse files Browse the repository at this point in the history
  • Loading branch information
cmuench committed Sep 12, 2023
1 parent 125d5f1 commit d3725f9
Show file tree
Hide file tree
Showing 3 changed files with 54 additions and 45 deletions.
5 changes: 4 additions & 1 deletion .github/workflows/linter.yml
Original file line number Diff line number Diff line change
Expand Up @@ -42,8 +42,11 @@ jobs:
uses: super-linter/super-linter/slim@v5
env:
VALIDATE_ALL_CODEBASE: false
VALIDATE_NATURAL_LANGUAGE: false
VALIDATE_MARKDOWN: true
VALIDATE_PHP_PHPCS: false
VALIDATE_PHP_PHPSTAN: false
VALIDATE_PHP_PSALM: false
DEFAULT_BRANCH: develop
MARKDOWN_CONFIG_FILE: '.markdown-lint.yml'
DEFAULT_BRANCH: 'develop'
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
3 changes: 3 additions & 0 deletions .markdown-lint.yml
Original file line number Diff line number Diff line change
@@ -1,6 +1,9 @@
{
"default": true,
"MD007": { "indent": 4 },
"MD009": {
"no_trailing_spaces": false,
},
"MD013": {
"line_length": 160,
"code_blocks": false,
Expand Down
91 changes: 47 additions & 44 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -116,8 +116,8 @@ The main advantage of the dist package is that there are no package dependencies

### Install with Composer (Source Package) - not recommended

The installation via Composer is **not recommended**,
because it's impossible to be compatible with all project and Magento core dependencies.
The installation via Composer is **not recommended**,
because it's impossible to be compatible with all project and Magento core dependencies.
Please use the phar file instead of the Composer version. We are not able to provide
compatibility to all Magento versions anymore.

Expand Down Expand Up @@ -196,16 +196,18 @@ Global config parameters:

### Call Core Magento Commands

The tool can be used to run core Magento commands. We provide a internal *Proxy Command* which calls
The tool can be used to run core Magento commands. We provide a internal *Proxy Command* which calls
the original Magento command via `bin/magento`.
All options and arguments are passed to the original command.

If you do not want to use the proxy command you can disable it with the `--skip-core-commands` option.

One of the big advantages of the proxy command is that you can run any command without having to change the working directory to the Magento root directory
One of the big advantages of the proxy command is that you can run any command without having to change the working
directory to the Magento root directory
or to specify the path to `bin/magento` if your current working directory is inside the Magento installation.

If you are outside the Magento root directory you can run any command by specifying the Magento root directory with the `--root-dir` option.
If you are outside the Magento root directory you can run any command by specifying the Magento root directory with
the `--root-dir` option.
That is very useful if you have multiple Magento installations or if it is used in some kind of automation.

For core commands we filter environment variables to avoid problems with enabled xdebug extension.
Expand Down Expand Up @@ -246,7 +248,6 @@ You can add additional any number of custom fields, example:
n98-magerun2.phar customer:create [email protected] passworD123 John Doe base taxvat DE12345678 prefix Mrs.
```


### List Customers

List customers. The output is limited to 1000 (can be changed by
Expand Down Expand Up @@ -578,11 +579,11 @@ n98-magerun2.phar config:data:mview [options]
**Options:**
| Option | Description |
|-------------------|---------------------------------------------------------------|
| `--scope` `-s` | Config scope (`global`, `adminhtml`, `frontend`, `webapi_rest`, `webapi_soap`, ...) (default: `global`) |
| `--tree` `-t` | Print data as tree |
| `--format` | Output as `json`, `xml` or `csv` |
| Option | Description |
|----------------|---------------------------------------------------------------------------------------------------------|
| `--scope` `-s` | Config scope (`global`, `adminhtml`, `frontend`, `webapi_rest`, `webapi_soap`, ...) (default: `global`) |
| `--tree` `-t` | Print data as tree |
| `--format` | Output as `json`, `xml` or `csv` |
### Print Indexer Config
Expand All @@ -594,11 +595,11 @@ n98-magerun2.phar config:data:indexer [options]
**Options:**
| Option | Description |
|-------------------|---------------------------------------------------------------|
| `--scope` `-s` | Config scope (`global`, `adminhtml`, `frontend`, `webapi_rest`, `webapi_soap`, ...) (default: `global`) |
| `--tree` `-t` | Print data as tree |
| `--format` | Output as `json`, `xml` or `csv` |
| Option | Description |
|----------------|---------------------------------------------------------------------------------------------------------|
| `--scope` `-s` | Config scope (`global`, `adminhtml`, `frontend`, `webapi_rest`, `webapi_soap`, ...) (default: `global`) |
| `--tree` `-t` | Print data as tree |
| `--format` | Output as `json`, `xml` or `csv` |
---
Expand Down Expand Up @@ -685,7 +686,7 @@ n98-magerun2.phar cache:view [--unserialize] [--decrypt] [--fpc] id
If value is serialized you can force a pretty output with `--unserialize` option.
Some entries are encrypted and can be decrypted with `--decrypt` option.
The command uses the core cache by default.
The command uses the core cache by default.
If the FPC cache should be used, the `--fpc` option can be used.
### Flush Catalog Images Cache
Expand Down Expand Up @@ -771,25 +772,25 @@ Arguments:
Options:
| Option | Description |
|----------------------------|----------------------------------------------------------------------------------------------|
| `--add-routines` | Include stored routines in dump (procedures & functions). |
| `--add-time suffix` | Adds time to filename (only if filename was provided). Requires value [suffix, prefix, no] |
| `--compression` `-c` | Compress the dump file using one of the supported algorithms |
| `--dry-run` | Do everything but the actual dump. Useful to test. |
| `--exclude` | Tables to exclude entirely from the dump (including structure) |
| `--force` `-f` | Do not prompt if all options are defined |
| `--git-friendly` | Use one insert statement, but with line breaks instead of separate insert statements. |
| `--human-readable` | Use a single insert with column names per row. |
| `--include` | Tables to include entirely to the dump (default: all tables are included) |
| `--keep-column-statistics` | Retains `column statistics` table in `mysqldump` |
| `--no-single-transaction` | Do not use single-transaction (not recommended, this is blocking) |
| `--no-tablespaces` | Use this option if you want to create a dump without having the PROCESS privilege. |
| `--only-command` | Print only mysqldump command. Does not execute. |
| `--print-only-filename` | Execute and prints not output except the dump filename |
| `--set-gtid-purged-off` | Adds --set-gtid-purged=OFF to mysqlqump |
| `--stdout` | Dump to stdout |
| `--strip` | Tables to strip (dump only structure of those tables) |
| Option | Description |
|----------------------------|--------------------------------------------------------------------------------------------|
| `--add-routines` | Include stored routines in dump (procedures & functions). |
| `--add-time suffix` | Adds time to filename (only if filename was provided). Requires value [suffix, prefix, no] |
| `--compression` `-c` | Compress the dump file using one of the supported algorithms |
| `--dry-run` | Do everything but the actual dump. Useful to test. |
| `--exclude` | Tables to exclude entirely from the dump (including structure) |
| `--force` `-f` | Do not prompt if all options are defined |
| `--git-friendly` | Use one insert statement, but with line breaks instead of separate insert statements. |
| `--human-readable` | Use a single insert with column names per row. |
| `--include` | Tables to include entirely to the dump (default: all tables are included) |
| `--keep-column-statistics` | Retains `column statistics` table in `mysqldump` |
| `--no-single-transaction` | Do not use single-transaction (not recommended, this is blocking) |
| `--no-tablespaces` | Use this option if you want to create a dump without having the PROCESS privilege. |
| `--only-command` | Print only mysqldump command. Does not execute. |
| `--print-only-filename` | Execute and prints not output except the dump filename |
| `--set-gtid-purged-off` | Adds --set-gtid-purged=OFF to mysqlqump |
| `--stdout` | Dump to stdout |
| `--strip` | Tables to strip (dump only structure of those tables) |
```sh
n98-magerun2.phar db:dump
Expand Down Expand Up @@ -819,7 +820,8 @@ Dumps your database and excludes some tables. This is useful for
development or staging environments where you may want to provision a
restricted database.
Separate each table to strip by a space. You can use wildcards like `*` and `?` in the table names to strip multiple tables.
Separate each table to strip by a space. You can use wildcards like `*` and `?` in the table names to strip multiple
tables.
In addition, you can specify pre-defined table groups, that start with an @ sign.
Example: `dataflow_batch_export unimportant_module_* @log`
Expand Down Expand Up @@ -879,14 +881,14 @@ Options:
| `--optimize` | Convert verbose INSERTs to short ones before import (not working with compression) |
| `--skip-authorization-entry-creation` | Add default entry to authorization_role and authorization_rule tables. |
```sh
n98-magerun2.phar db:import
```
### Fix empty authorization tables
If you run `db:dump` with stripped option and `@admin` group, the authorization_rule and authorization_role tables are empty.
If you run `db:dump` with stripped option and `@admin` group, the authorization_rule and authorization_role tables are
empty.
This blocks the creation of admin users.
You can re-create the default entries by running the command:
Expand Down Expand Up @@ -1201,11 +1203,11 @@ Variable `$di` is made available with a
`Magento\Framework\ObjectManagerInterface` instance to allow creation of
object instances.
Variable `$dh` provides convenient debugging functions. Type `$dh->` and press
Tab for a list.
Variable `$dh` provides convenient debugging functions.
Type `$dh->` and press Tab for a list.
Example:
```bash
n98-magerun2 dev:console --area=adminhtml
// show name of category 123 in default store
Expand Down Expand Up @@ -1357,7 +1359,7 @@ Create sales sequences in the database if they are missing, this will recreate p
n98-magerun2.phar sales:sequence:add [store]
```
If store is omitted, it'll run for all stores.
If store is omitted, it'll run for all stores.
*Note: It is possible a sequence already exists, in this case nothing will happen, only missing tables are created.*
Expand All @@ -1369,7 +1371,8 @@ Remove sales sequences from the database, warning, you cannot undo this, make su
n98-magerun2.phar sales:sequence:remove [store]
```
If store is omitted, it'll run for all stores. When the option `no-interaction` is given, it will run immediately without any interaction.
If store is omitted, it'll run for all stores. When the option `no-interaction` is given, it will run immediately
without any interaction.
Otherwise it will remind you and ask if you know what you're doing and ask for each store you are running it on.
*Note: .*
Expand Down

0 comments on commit d3725f9

Please sign in to comment.