# Project generator
[](https://travis-ci.org/project-generator/project_generator)
Source code is often times simple but building it is difficult when more than one person is involved.
Developers like what they like: IDE, compiler, debugger and really all we want is to produce an executable.
Sharing project files decoding XML in commit messages because someone was debugging and changed compile options before commiting distracts from doing what you want to do; develop software.
This project allows you to define a project in text using YAML files and generate IDE project files
based on the rules defined in records. No one should ever commit IDE specific project file to a repository again!
All open sourced - licensed under Apache v2.0 license.
### Current Status
The project is in alpha phase. Check issues for the ongoing tasks or todo tasks.
Project generator currently generaters projects for the following tools (IDE, Makefile, etc..):
- uVision4 and uVision5
- IAR
- Makefile (GCC ARM)
- Makefile (ARMCC)
- Cmake (GCC ARM)
- CoIDE (GCC ARM)
- Eclipse (Makefile with GCC ARM)
- Sublime (Makefile with GCC ARM)
- Visual studio (Makefile with GCC ARM)
We appreciate any help and you are more than welcome to send a pull request or create a new issue in this repository.
The plan is to support as many IDE as possible , same applies for targets/MCU.
### How to use it
There are two options, how to use it. Either you download [pypi package](https://pypi.python.org/pypi/project_generator) or you can clone this repository to your project directory.
##### Using package
Once installed, test if project_generator is recognized:
```
progen --version
```
This should print the current installed version. You can use progen or project_generator as a command.
##### Using directly the repository
In case of using this repository directly, be aware, the project generator is using relative paths. To solve this, invoke run.py with arguments as you would if using the package. Something like: python run.py --version. This helps with debugging the package.
##### Getting started
An example how to use progen [baremetal blinky examples](https://github.com/project-generator/project_generator_frdm_boards_example) or more advanced [mbed blinky examples](https://github.com/project-generator/project_generator_mbed_examples).
###### Docs
To get familiar with it, read our wiki. Good start is [Getting started guide (wiki)](https://github.com/project-generator/project_generator/wiki/Getting_started). There are other sections which describe the each blocks of the project generator.
##### Add a new target/mcu
We use project generator definitions, which is a separate python module and contains mcu/target database plus parser to obtain those from tools projects, visit github page [here](https://github.com/project-generator/project_generator_definitions/).
Dependencies for Project generator
-------------------------
* Python 2.7.x/3.x
* [pyYAML](https://github.com/yaml/pyyaml)
* [Setuptools](https://pypi.python.org/pypi/distribute)
* [Jinja2](https://pypi.python.org/pypi/Jinja2)
* [xmltodict](https://pypi.python.org/pypi/xmltodict)
* [project generator definitions](https://pypi.python.org/pypi/project_generator_definitions)
Raw data
{
"_id": null,
"home_page": "https://github.com/project-generator/project_generator",
"name": "project-generator",
"maintainer": "Martin Kojtal",
"docs_url": null,
"requires_python": "",
"maintainer_email": "c0170@rocketmail.com",
"keywords": "c cpp project generator embedded",
"author": "",
"author_email": "",
"download_url": "https://files.pythonhosted.org/packages/f4/47/fd0cac2fff5d6a13952c6d88bb34d41572395841477f48e15db28e33b470/project_generator-0.12.0.tar.gz",
"platform": null,
"description": "# Project generator\r\n[](https://travis-ci.org/project-generator/project_generator)\r\n\r\nSource code is often times simple but building it is difficult when more than one person is involved.\r\nDevelopers like what they like: IDE, compiler, debugger and really all we want is to produce an executable.\r\nSharing project files decoding XML in commit messages because someone was debugging and changed compile options before commiting distracts from doing what you want to do; develop software.\r\n\r\nThis project allows you to define a project in text using YAML files and generate IDE project files\r\nbased on the rules defined in records. No one should ever commit IDE specific project file to a repository again!\r\n\r\nAll open sourced - licensed under Apache v2.0 license.\r\n\r\n### Current Status\r\n\r\nThe project is in alpha phase. Check issues for the ongoing tasks or todo tasks.\r\n\r\nProject generator currently generaters projects for the following tools (IDE, Makefile, etc..):\r\n\r\n - uVision4 and uVision5\r\n - IAR\r\n - Makefile (GCC ARM)\r\n - Makefile (ARMCC)\r\n - Cmake (GCC ARM)\r\n - CoIDE (GCC ARM)\r\n - Eclipse (Makefile with GCC ARM)\r\n - Sublime (Makefile with GCC ARM)\r\n - Visual studio (Makefile with GCC ARM)\r\n\r\nWe appreciate any help and you are more than welcome to send a pull request or create a new issue in this repository.\r\nThe plan is to support as many IDE as possible , same applies for targets/MCU.\r\n\r\n### How to use it\r\n\r\nThere are two options, how to use it. Either you download [pypi package](https://pypi.python.org/pypi/project_generator) or you can clone this repository to your project directory.\r\n\r\n##### Using package\r\nOnce installed, test if project_generator is recognized:\r\n\r\n```\r\nprogen --version\r\n```\r\n\r\nThis should print the current installed version. You can use progen or project_generator as a command.\r\n\r\n##### Using directly the repository\r\nIn case of using this repository directly, be aware, the project generator is using relative paths. To solve this, invoke run.py with arguments as you would if using the package. Something like: python run.py --version. This helps with debugging the package.\r\n\r\n##### Getting started\r\n\r\nAn example how to use progen [baremetal blinky examples](https://github.com/project-generator/project_generator_frdm_boards_example) or more advanced [mbed blinky examples](https://github.com/project-generator/project_generator_mbed_examples).\r\n\r\n###### Docs\r\nTo get familiar with it, read our wiki. Good start is [Getting started guide (wiki)](https://github.com/project-generator/project_generator/wiki/Getting_started). There are other sections which describe the each blocks of the project generator.\r\n\r\n##### Add a new target/mcu\r\n\r\nWe use project generator definitions, which is a separate python module and contains mcu/target database plus parser to obtain those from tools projects, visit github page [here](https://github.com/project-generator/project_generator_definitions/).\r\n\r\nDependencies for Project generator\r\n-------------------------\r\n* Python 2.7.x/3.x\r\n * [pyYAML](https://github.com/yaml/pyyaml)\r\n * [Setuptools](https://pypi.python.org/pypi/distribute)\r\n * [Jinja2](https://pypi.python.org/pypi/Jinja2)\r\n * [xmltodict](https://pypi.python.org/pypi/xmltodict)\r\n * [project generator definitions](https://pypi.python.org/pypi/project_generator_definitions)\r\n",
"bugtrack_url": null,
"license": "Apache 2.0",
"summary": "Project generators for various embedded tools (IDE). IAR, uVision, Makefile and many more in the roadmap!",
"version": "0.12.0",
"split_keywords": [
"c",
"cpp",
"project",
"generator",
"embedded"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "1dfff53d8dd8829688e78e15f7017959d3da6e25fe23a970d0ed751aae78b578",
"md5": "dcf7410c73b1f7ac9141ccca3f0bef1e",
"sha256": "8dd9b1639db4f0838f768cce0d25d0ef79a03980de53e33b7e728db755b1db3e"
},
"downloads": -1,
"filename": "project_generator-0.12.0-py2.py3-none-any.whl",
"has_sig": false,
"md5_digest": "dcf7410c73b1f7ac9141ccca3f0bef1e",
"packagetype": "bdist_wheel",
"python_version": "py2.py3",
"requires_python": null,
"size": 106562,
"upload_time": "2023-03-15T17:17:46",
"upload_time_iso_8601": "2023-03-15T17:17:46.535754Z",
"url": "https://files.pythonhosted.org/packages/1d/ff/f53d8dd8829688e78e15f7017959d3da6e25fe23a970d0ed751aae78b578/project_generator-0.12.0-py2.py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "f447fd0cac2fff5d6a13952c6d88bb34d41572395841477f48e15db28e33b470",
"md5": "9566ecda70bf253fcf6dd0574810202c",
"sha256": "09001ea5f04fc4294ad970f84acbeec1fb937662cd7425c05f5f463385002683"
},
"downloads": -1,
"filename": "project_generator-0.12.0.tar.gz",
"has_sig": false,
"md5_digest": "9566ecda70bf253fcf6dd0574810202c",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 78742,
"upload_time": "2023-03-15T17:17:48",
"upload_time_iso_8601": "2023-03-15T17:17:48.417359Z",
"url": "https://files.pythonhosted.org/packages/f4/47/fd0cac2fff5d6a13952c6d88bb34d41572395841477f48e15db28e33b470/project_generator-0.12.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-03-15 17:17:48",
"github": true,
"gitlab": false,
"bitbucket": false,
"github_user": "project-generator",
"github_project": "project_generator",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "project-generator"
}
JSON
