Requirements

Docker

TODO

Install

Env variables

Create the following files in the infra directory of this project.

# blackfire.envBLACKFIRE_SERVER_ID=BLACKFIRE_SERVER_TOKEN=BLACKFIRE_CLIENT_ID=BLACKFIRE_CLIENT_TOKEN=

See Blackfire chapter for more

# php.envPHP_XDEBUG_ENABLED=1APP_SWITCH_ENV=true# Host = docker network inspect "${NETWORK_NAME:?}" -f "{{range .IPAM.Config }}{{ .Gateway }}{{end}}"# Port = ARBITRARYXDEBUG_CONFIG=remote_host=172.28.0.4 remote_port=30093

Compiling the compose files

Local

Create the .env file in the infra directory while making sure the values are the correct ones:

$ cat > ./.env <<EOF# https://docs.docker.com/compose/reference/envvars/COMPOSE_PROJECT_NAME=app-cli# Path from the root of this project to the root of the symfony projectAPP_PROJECT_PATH=../# Fix permissions issuesAPP_USER_ID=$(id -u)EOF

Running the containers

Local

$ docker-compose pull; \
docker-compose up -d --remove-orphans --build

The pull will show some errors. As long as it concerns php or tools it is fine. (mix of build + image in docker-compose).

Setting up the project locally

Use the functions.sh

This file is to ease the use of containers without thinking about it when developing.

$ source ./functions.sh

Setup autoloading

$ composer install

Running tests

$ unit-tests

Usage

$ csv2json
$ # example:
$ csv2json --desc ./fixtures/simple.ini --pretty ./fixtures/simple.csv

Blackfire

Connect to Blackfire docker integration documentation and copy paste your environments variables in blackfire.env file above.

⚠️ For now Blackfire could not work with Xdebug enabled. Set ENABLE_XDEBUG to false if you want to profile with Blackfire.

TODO

• Do a custom parsing of cli arguments using $argv
• Create a App\Cli\Csv2Json class with private methods such as: ['parseArgv', 'handleError', 'showUsage', ...]
• Create a parser for the 'schema' file instead of using 'ini' parser
• Create more tests
• Split App\Parser\Csv\Parser in several methods
• Redo the InputOption (use short syntax as alias to long ones and vice versa; )
• Check that the aggregate field is in the fields filter list
• Redo App\Parser\Csv\Tools::guessDelimiter() based on App\Cli\InputOption::parseStringToArray()
• Check if files exists (realpath) AND are readable
• Add output colors to the Terminal class