.. image:: https://zenodo.org/badge/DOI/10.5281/zenodo.8370310.svg
:target: https://doi.org/10.5281/zenodo.8370310
:align: right
==========
pymetacode
==========
*A Python package helping to write and maintain Python packages.*
**Code that writes code** -- yes, that's correct. Automating the boring stuff, one could say, or helping to focus on the creative part of programming. In any case, the idea for this package stems from experience with a couple of Python projects, and as such it is pretty *opinionated*, focussing on personal needs regarding structure and layout. Nevertheless, it tries to be as user-friendly as possible, coming with an intuitive command-line interface (CLI).
Want to get an idea? Here you go. **Creating a new package** would be a two-step process:
1) Write a configuration file for your new package (and afterwards fill it with sensible content)
.. code-block:: bash
pymeta write config to mypackage_config.yaml
2) Create the basic Python package structure for your package.
.. code-block:: bash
pymeta create package from mypackage_config.yaml
Once you have your package structure, you can **add modules, classes, and functions** to your package from *within the package's root directory* at any time:
.. code-block:: bash
pymeta add module mymodule
pymeta add class MyClass to mymodule
pymeta add function my_function to mymodule
If you ever want to add a **graphical user interface (GUI)** to your project, this is (now) possible as well:
.. code-block:: bash
pymeta add gui
pymeta add window mysubwindow
And now - happy coding!
Features
========
A list of features:
* Create initial package structure (directory layout, files)
* Add module, class, and function scaffolds to an existing project, including tests and API documentation
* Add initial (Qt) GUI subpackage structure (directory layout, files)
* Add (Qt) GUI window scaffolds to existing project, including tests and API documentation
* Intuitive command-line interface (CLI)
* Initialise git repository; automatically incrementing version number with each commit
And to make it even more convenient for users and future-proof:
* Open source project written in Python (>= 3.7)
* Developed fully test-driven
* Extensive user and API documentation
Installation
============
To install the pymetacode package on your computer (sensibly within a Python virtual environment), open a terminal (activate your virtual environment), and type in the following:
.. code-block:: bash
pip install pymetacode
License
=======
This program is free software: you can redistribute it and/or modify it under the terms of the **BSD License**.
Raw data
{
"_id": null,
"home_page": "https://www.meta-co.de/",
"name": "pymetacode",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": null,
"keywords": "metaprogramming, Python packages, automation, code generation",
"author": "Till Biskup",
"author_email": "till@till-biskup.de",
"download_url": "https://files.pythonhosted.org/packages/b2/65/5e94c65a481ddd61294f366a7581128f29d7ff384156dcbaf412f44efa56/pymetacode-0.6.0.tar.gz",
"platform": null,
"description": "\n.. image:: https://zenodo.org/badge/DOI/10.5281/zenodo.8370310.svg\n :target: https://doi.org/10.5281/zenodo.8370310\n :align: right\n\n==========\npymetacode\n==========\n\n*A Python package helping to write and maintain Python packages.*\n\n**Code that writes code** -- yes, that's correct. Automating the boring stuff, one could say, or helping to focus on the creative part of programming. In any case, the idea for this package stems from experience with a couple of Python projects, and as such it is pretty *opinionated*, focussing on personal needs regarding structure and layout. Nevertheless, it tries to be as user-friendly as possible, coming with an intuitive command-line interface (CLI).\n\nWant to get an idea? Here you go. **Creating a new package** would be a two-step process:\n\n1) Write a configuration file for your new package (and afterwards fill it with sensible content)\n\n.. code-block:: bash\n\n pymeta write config to mypackage_config.yaml\n\n2) Create the basic Python package structure for your package.\n\n.. code-block:: bash\n\n pymeta create package from mypackage_config.yaml\n\nOnce you have your package structure, you can **add modules, classes, and functions** to your package from *within the package's root directory* at any time:\n\n.. code-block:: bash\n\n pymeta add module mymodule\n pymeta add class MyClass to mymodule\n pymeta add function my_function to mymodule\n\nIf you ever want to add a **graphical user interface (GUI)** to your project, this is (now) possible as well:\n\n.. code-block:: bash\n\n pymeta add gui\n pymeta add window mysubwindow\n\nAnd now - happy coding!\n\n\nFeatures\n========\n\nA list of features:\n\n* Create initial package structure (directory layout, files)\n\n* Add module, class, and function scaffolds to an existing project, including tests and API documentation\n\n* Add initial (Qt) GUI subpackage structure (directory layout, files)\n\n* Add (Qt) GUI window scaffolds to existing project, including tests and API documentation\n\n* Intuitive command-line interface (CLI)\n\n* Initialise git repository; automatically incrementing version number with each commit\n\n\nAnd to make it even more convenient for users and future-proof:\n\n* Open source project written in Python (>= 3.7)\n\n* Developed fully test-driven\n\n* Extensive user and API documentation\n\n\nInstallation\n============\n\nTo install the pymetacode package on your computer (sensibly within a Python virtual environment), open a terminal (activate your virtual environment), and type in the following:\n\n.. code-block:: bash\n\n pip install pymetacode\n\n\nLicense\n=======\n\nThis program is free software: you can redistribute it and/or modify it under the terms of the **BSD License**.\n\n",
"bugtrack_url": null,
"license": "BSD",
"summary": "A Python package helping to write and maintain Python packages.",
"version": "0.6.0",
"project_urls": {
"Documentation": "https://python.docs.meta-co.de/",
"Homepage": "https://www.meta-co.de/",
"Source": "https://github.com/tillbiskup/pymetacode"
},
"split_keywords": [
"metaprogramming",
" python packages",
" automation",
" code generation"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "547d29e1002c3c472417e8c193ecc69368cfccaffbe9b4622eb0f00d85f16199",
"md5": "7dabfbaaf92d30a5c6aee9ded31dae23",
"sha256": "4bdce47829816573240cdcbd5b81d9e728fa2e6748a46a266fb743751d73571c"
},
"downloads": -1,
"filename": "pymetacode-0.6.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "7dabfbaaf92d30a5c6aee9ded31dae23",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 113175,
"upload_time": "2024-07-22T16:16:28",
"upload_time_iso_8601": "2024-07-22T16:16:28.005264Z",
"url": "https://files.pythonhosted.org/packages/54/7d/29e1002c3c472417e8c193ecc69368cfccaffbe9b4622eb0f00d85f16199/pymetacode-0.6.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "b2655e94c65a481ddd61294f366a7581128f29d7ff384156dcbaf412f44efa56",
"md5": "cd5f02f76217fcda1c7b3f5bea0ef759",
"sha256": "8414953758f804b9eeafdeb04c19711ac851f65350955e035c34405c0fc8cbbe"
},
"downloads": -1,
"filename": "pymetacode-0.6.0.tar.gz",
"has_sig": false,
"md5_digest": "cd5f02f76217fcda1c7b3f5bea0ef759",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 107496,
"upload_time": "2024-07-22T16:16:30",
"upload_time_iso_8601": "2024-07-22T16:16:30.106405Z",
"url": "https://files.pythonhosted.org/packages/b2/65/5e94c65a481ddd61294f366a7581128f29d7ff384156dcbaf412f44efa56/pymetacode-0.6.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-07-22 16:16:30",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "tillbiskup",
"github_project": "pymetacode",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"tox": true,
"lcname": "pymetacode"
}