pymetacode


Namepymetacode JSON
Version 0.6.0 PyPI version JSON
download
home_pagehttps://www.meta-co.de/
SummaryA Python package helping to write and maintain Python packages.
upload_time2024-07-22 16:16:30
maintainerNone
docs_urlNone
authorTill Biskup
requires_python>=3.7
licenseBSD
keywords metaprogramming python packages automation code generation
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            
.. 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"
}
        
Elapsed time: 4.88820s