ProductPromotion
Logo

Python.py

made by https://0x3d.site

GitHub - copier-org/copier: Library and command-line utility for rendering projects templates.
Library and command-line utility for rendering projects templates. - copier-org/copier
Visit Site

GitHub - copier-org/copier: Library and command-line utility for rendering projects templates.

GitHub - copier-org/copier: Library and command-line utility for rendering projects templates.

Copier

Copier Gitpod ready-to-code codecov CI Checked with mypy Python PyPI Code style: black Documentation Status

A library and CLI app for rendering project templates.

  • Works with local paths and Git URLs.
  • Your project can include any file and Copier can dynamically replace values in any kind of text file.
  • It generates a beautiful output and takes care of not overwriting existing files unless instructed to do so.

Sample output

Installation

  1. Install Python 3.9 or newer.
  2. Install Git 2.27 or newer.
  3. To use as a CLI app: pipx install copier
  4. To use as a library: pip install copier or conda install -c conda-forge copier

Nix flake

To install latest Copier release with 100% reproducibility:

nix profile install 'https://flakehub.com/f/copier-org/copier/*.tar.gz'

Quick start

To create a template:

📁 my_copier_template                        # your template project
├── 📄 copier.yml                            # your template configuration
├── 📁 .git/                                 # your template is a Git repository
├── 📁 {{project_name}}                      # a folder with a templated name
│   └── 📄 {{module_name}}.py.jinja          # a file with a templated name
└── 📄 {{_copier_conf.answers_file}}.jinja   # answers are recorded here
# questions
project_name:
    type: str
    help: What is your project name?

module_name:
    type: str
    help: What is your Python module name?
print("Hello from {{module_name}}!")
# Changes here will be overwritten by Copier
{{ _copier_answers|to_nice_yaml -}}

To generate a project from the template:

  • On the command-line:

    copier copy path/to/project/template path/to/destination
    
  • Or in Python code, programmatically:

    from copier import run_copy
    
    # Create a project from a local path
    run_copy("path/to/project/template", "path/to/destination")
    
    # Or from a Git URL.
    run_copy("https://github.com/copier-org/copier.git", "path/to/destination")
    
    # You can also use "gh:" as a shortcut of "https://github.com/"
    run_copy("gh:copier-org/copier.git", "path/to/destination")
    
    # Or "gl:" as a shortcut of "https://gitlab.com/"
    run_copy("gl:copier-org/copier.git", "path/to/destination")
    

Basic concepts

Copier is composed of these main concepts:

  1. Templates. They lay out how to generate the subproject.
  2. Questionnaires. They are configured in the template. Answers are used to generate projects.
  3. Projects. This is where your real program lives. But it is usually generated and/or updated from a template.

Copier targets these main human audiences:

  1. Template creators. Programmers that repeat code too much and prefer a tool to do it for them.

    Tip: Copier doesn't replace the DRY principle... but sometimes you simply can't be DRY and you need a DRYing machine...

  2. Template consumers. Programmers that want to start a new project quickly, or that want to evolve it comfortably.

Non-humans should be happy also by using Copier's CLI or API, as long as their expectations are the same as for those humans... and as long as they have feelings.

Templates have these goals:

  1. Code scaffolding. Help consumers have a working source code tree as quickly as possible. All templates allow scaffolding.
  2. Code lifecycle management. When the template evolves, let consumers update their projects. Not all templates allow updating.

Copier tries to have a smooth learning curve that lets you create simple templates that can evolve into complex ones as needed.

Browse or tag public templates

You can browse public Copier templates on GitHub using the copier-template topic. Use them as inspiration!

If you want your template to appear in that list, just add the topic to it! 🏷

Show your support

If you're using Copier, consider adding the Copier badge to your project's README.md:

[![Copier](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/copier-org/copier/master/img/badge/badge-grayscale-inverted-border-orange.json)](https://github.com/copier-org/copier)

...or README.rst:

.. image:: https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/copier-org/copier/master/img/badge/badge-grayscale-inverted-border-orange.json
    :target: https://github.com/copier-org/copier
    :alt: Copier

...or, as HTML:

<a href="https://github.com/copier-org/copier"><img src="https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/copier-org/copier/master/img/badge/badge-grayscale-inverted-border-orange.json" alt="Copier" style="max-width:100%;"/></a>

Copier badge variations

  1. Badge Grayscale Border Copier

  2. Badge Grayscale Inverted Border Copier

  3. Badge Grayscale Inverted Border Orange Copier

  4. Badge Grayscale Inverted Border Red Copier

  5. Badge Grayscale Inverted Border Teal Copier

  6. Badge Grayscale Inverted Border Purple Copier

  7. Badge Black Copier

Credits

Special thanks go to jpsca for originally creating Copier. This project would not be a thing without him.

Many thanks to pykong who took over maintainership on the project, promoted it, and laid out the bases of what the project is today.

Big thanks also go to yajo for his relentless zest for improving Copier even further.

Thanks a lot, pawamoy for polishing very important rough edges and improving the documentation and UX a lot.

Also special thanks to sisp for being very helpful in polishing documentation, fixing bugs, helping the community and cleaning up the codebase.

And thanks to all financial supporters and folks that give us a shiny star! ⭐

Articles
to learn more about the python concepts.

Resources
which are currently available to browse on.

mail [email protected] to add your project or resources here 🔥.

FAQ's
to know more about the topic.

mail [email protected] to add your project or resources here 🔥.

Queries
or most google FAQ's about Python.

mail [email protected] to add more queries here 🔍.

More Sites
to check out once you're finished browsing here.

0x3d
https://www.0x3d.site/
0x3d is designed for aggregating information.
NodeJS
https://nodejs.0x3d.site/
NodeJS Online Directory
Cross Platform
https://cross-platform.0x3d.site/
Cross Platform Online Directory
Open Source
https://open-source.0x3d.site/
Open Source Online Directory
Analytics
https://analytics.0x3d.site/
Analytics Online Directory
JavaScript
https://javascript.0x3d.site/
JavaScript Online Directory
GoLang
https://golang.0x3d.site/
GoLang Online Directory
Python
https://python.0x3d.site/
Python Online Directory
Swift
https://swift.0x3d.site/
Swift Online Directory
Rust
https://rust.0x3d.site/
Rust Online Directory
Scala
https://scala.0x3d.site/
Scala Online Directory
Ruby
https://ruby.0x3d.site/
Ruby Online Directory
Clojure
https://clojure.0x3d.site/
Clojure Online Directory
Elixir
https://elixir.0x3d.site/
Elixir Online Directory
Elm
https://elm.0x3d.site/
Elm Online Directory
Lua
https://lua.0x3d.site/
Lua Online Directory
C Programming
https://c-programming.0x3d.site/
C Programming Online Directory
C++ Programming
https://cpp-programming.0x3d.site/
C++ Programming Online Directory
R Programming
https://r-programming.0x3d.site/
R Programming Online Directory
Perl
https://perl.0x3d.site/
Perl Online Directory
Java
https://java.0x3d.site/
Java Online Directory
Kotlin
https://kotlin.0x3d.site/
Kotlin Online Directory
PHP
https://php.0x3d.site/
PHP Online Directory
React JS
https://react.0x3d.site/
React JS Online Directory
Angular
https://angular.0x3d.site/
Angular JS Online Directory