.. _pwrforge_x86:

Creating and working with x86 cpp project
=========================================
.. image:: ../_static/pwrforge_flow_docker.svg
   :alt: pwrforge x86 flow
   :align: center

Creating x86 cpp project
------------------------


To create *Hello world* x86 cpp project we will use :doc:`pwrforge new command </pwrforge/pwrforge-new>`:

Open the command line and run: ::

    pwrforge new --target x86 --bin hello_world hello_world_project

This will create a new dockerized x86 cpp project inside hello_world_project directory.
If you want to create a native project you can add *--no-docker* argument.

This is how the project directory will look like: ::

    └── hello_world_project
        ├── CMakeLists.txt
        ├── conanfile.py
        ├── LICENSE
        ├── README.md
        ├── pwrforge.lock
        ├── pwrforge.toml
        ├── src
        │   ├── CMakeLists.txt
        │   └── hello_world.cpp
        └── tests
            ├── CMakeLists.txt
            ├── it
            │   └── CMakeLists.txt
            ├── mocks
            │   ├── CMakeLists.txt
            │   └── static_mock
            │       ├── CMakeLists.txt
            │       └── static_mock.h
            └── ut
                └── CMakeLists.txt


For pwrforge the most important file is *pwrforge.toml*. This is the file in which you write your project configuration.
If you want to update some settings in *pwrforge.toml* make sure you run pwrforge update command to update the project with
the newly modified configuration.

More on this can be read in :doc:`/pwrforge/pwrforge-toml`

Building the project
--------------------

To build the project we can change into project directory and run :doc:`pwrforge build command </pwrforge/pwrforge-build>`.
Let's run the build command and build our project in *Release* ::

    cd hello_world_project
    pwrforge build --profile Release

By default, pwrforge builds in *Debug*, but you can switch it by running it with --profile argument (e.g. --profile=Release).
pwrforge will use conan to download all necessary dependencies and build the project.
After the build is finished we should see that *build/Release* directory was created and the build files are inside.

Running the binary
------------------

To run the binary we can simply use :doc:`pwrforge run command </pwrforge/pwrforge-run>`: ::

    pwrforge run --profile Release

After running the command we will see *Hello world!* text in the terminal.
If the project wasn't built for the profile that we want to run yet, run it with ``--build``.
By default, run environment follows ``build-env`` from ``pwrforge.toml``.
Use ``--docker`` or ``--native`` to override it.

Debugging
---------

pwrforge also supports debugging through gdb cli. We will first build our project in Debug and then we can run :doc:`pwrforge debug command </pwrforge/pwrforge-debug>`: ::

    pwrforge build --profile Debug
    pwrforge debug