Skip to content

Latest commit

 

History

History
77 lines (46 loc) · 1.91 KB

CHEATSHEET.rst

File metadata and controls

77 lines (46 loc) · 1.91 KB
Raw

Finishing setting up your project

Thanks for using cookiecutter-trio! This is your project now; you can customize it however you like. Here's some reminders of things you might want to do to get started:

  • Add a CODE_OF_CONDUCT.md

  • Add a CONTRIBUTING.md

  • Enable Read the Docs. (Note: this project contains a .readthedocs.yml file that should be enough to get things working.)

  • Set up continuous integration: Currently, this project is set up to test on Linux and MacOS using Travis, on Windows using Appveyor, and to test on PyPy.

    If that's what you want, then go to Travis and Appveyor and enable testing for your repo.

    If that's not what you want, then you can trim the list by modifying (or deleting) .travis.yml, .appveyor.yml, ci/travis.sh.

  • Enable Codecov for your repo.

  • File bugs or pull requests on cookiecutter-trio reporting any problems or awkwardness you ran into (no matter how small!)

  • Delete this checklist once it's no longer useful

Tips

To run tests

  • Install requirements: pip install -r ci/test-requirements.txt (possibly in a virtualenv)
  • Actually run the tests: pytest asyncowfs

To run yapf

  • Show what changes yapf wants to make: yapf -rpd setup.py asyncowfs
  • Apply all changes directly to the source tree: yapf -rpi setup.py asyncowfs

To make a release

  • Update the version in asyncowfs/_version.py
  • Run towncrier to collect your release notes.
  • Review your release notes.
  • Check everything in.
  • Double-check it all works, docs build, etc.
  • Build your sdist and wheel: python setup.py sdist bdist_wheel
  • Upload to PyPI: twine upload dist/*
  • Use git tag to tag your version.
  • Don't forget to git push --tags.