Skip to main content

Creates a simple package structure, git, PyPI, bumpversion, pytest and configfile ready

Project description

Project codeframe

Creates a simple package structure, Fire, git, PyPI, bumpversion, pytest and configfile ready

Introduction

To create a new python project is a bit tedious task, especially if one doesn't know how to.

This purpose of this package is to make a simple, but still functional project structure.

Installation

pip3 install codeframe

Usage

Try just:

codeframe myproject myunit

This will create:

  • subdirectory named myproject and inside:
  • hardlink to bin/myproject named bin_myproject,
  • unit myunit, that is soft-linked as test_myunit, so it works with pytest,
  • version.py, that works with bumpversion
  • subsubdirectory myproject, that contains softlinks to ../ so that the package structure works
  • setup.py file, where you need to fill the requirements list and other things
  • README.org, that will generate README.md when ./distcheck is run
  • with config module it creates a new config DIR ~/.config/myproject
  • and some less important stuff

Highlights:

  1. The modules should be callable in jupyter that is opened in the myproj directory.
  2. The hardlink bin_myproject make the script inside bin/ callable (but git pull from elsewhere looses the hardlink!)
  3. Installable on local system with the usual command pip3 install -e .
  4. config module can be both - used at a new project and imported from any project from codeframe import config

./distcheck

  • generates README.md
  • creates git commit
  • bumpversion release
  • pushes to PyPI

Notes for development

Thanks to Fire, each module can be developed separately and CLI can be finally tuned in bin/myproject (hard-linked to bin_myproject) file.

TODO

  • topbar from gregory
  • keyenter ''

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

codeframe-0.2.5.tar.gz (14.1 kB view details)

Uploaded Source

File details

Details for the file codeframe-0.2.5.tar.gz.

File metadata

  • Download URL: codeframe-0.2.5.tar.gz
  • Upload date:
  • Size: 14.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.10.6

File hashes

Hashes for codeframe-0.2.5.tar.gz
Algorithm Hash digest
SHA256 3f15f76d38a6322b0ad847fa982c9eaecaf9c5175cb22d2c9b5627c0bed641a1
MD5 d80214d2a6a2d8fa94f58c0e93fa9858
BLAKE2b-256 00747a638393b38360a1b4357b67a26c8fe719eeae2b0fbcaefc44452c6401ea

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page