Skip to main content

Workflow | Create a new library

Brief

If you are about to create a small system that doesn't have any dependencies on the rest of Cool, then making it into a standalone library makes a lot of sense.
We try to do that whenever possible because it encourages a more decoupled and flexible design, and makes it easily reusable by others without having to include the whole of Cool.

How to

  • Create a new repository from our template:
    • ⚠️ Make sure the Owner is set to CoolLibs, not to your personal account!
    • Add a short description. (This is optional, you can add it later if you want).
    • Make sure the repo is public.
    • Don't check Include all branches.
    • Click Create repository from template.
  • Add the library to our list of Standalone libraries under ## Standalone libraries by adding:
<a href="https://github.com/CoolLibs/mynewlib">
<img align="center" src="https://github-readme-stats.vercel.app/api/pin/?username=CoolLibs&repo=mynewlib" />
</a>

(NB: Replace the two occurences of mynewlib with the name of your library).

  • Clone the repo recursively: git clone --recursive url/to/the/new/repo.
  • In the cloned repo, fill in "setup.py" and run the script: it will setup everything and then remove the Python scripts used for the setup and amend the initial commit.
  • commit as "🎉 Initial commit" and force push it.
  • Implement the library.
  • Once the library is stable and you are ready to mark it as v1, make a release on GitHub and write an article about it in our blog.