GithubHelp home page GithubHelp logo

jmartinm / cookiecutter-invenio-module Goto Github PK

View Code? Open in Web Editor NEW

This project forked from inveniosoftware/cookiecutter-invenio-module

0.0 1.0 0.0 120 KB

Cookiecutter - Invenio Module Template https://cookiecutter-invenio-module.readthedocs.org/en/latest/

License: GNU General Public License v2.0

Shell 0.76% Makefile 20.57% Python 59.37% Batchfile 19.29%

cookiecutter-invenio-module's Introduction

Cookiecutter - Invenio Module Template

image

image

image

This Cookiecutter template is designed to help you to bootstrap modules for Invenio. It offers you the following features:

  • Python package: Python package for your module including version submodule.
  • Boilderplate files: README including important badges, AUTHORS and CHANGES file.
  • License: GPL 2 file and headers. Headers optionally include a special paragraph for Intergovernmental Organizations like CERN. Provides these headers as reusable files for Python and reStructuredText.
  • Installation: Installation script written as setup.py and a requirements calculator for different levels (min, pypi, dev).
  • Tests: Test setup using pytest and configuration for Tox.
  • Documentation: Documentation generator using Sphinx. Also includes all files required for Read the Docs. Mocking module to simulate not-installed requirements for faster documentation building.
  • Continues Integration: Support for Travis which tests all three requirement levels and adds coverage tests using Coveralls.
  • Your toolchain: Ignores a decent set of files when working with GIT and Docker. Gets your editor to adapt project guidelines by providing a EditorConfig file.

Configuration

To generate correct files, please provide the following input to Cookiecutter:

project_name Full project name, might contain spaces.

project_shortname

Project shortname, no spaces allowed, use - as a separator.

package_name

Package/Module name for Python, must follow PEP 0008 <https://www.python.org/dev/peps/ pep-0008/>.

github_repo

GitHub repository of the project in form of USER/REPO, not the full GitHub URL.

description

A short description of the functionality of the module, its length should not extend one line.

author_name

The name of the primary author of the project, not necessarily the same as the copyright holder.

author_email E-Mail address of the primary author.
year Current year.

copyright_holder

Name of the person or organization who acts as the copyright holder of this project.

copyright_by_intergovernmental

Boolean flag that indicates that the copyright holder is an Intergovernmental Organization.

superproject

Project that contains the newly created Invenio module, or, in other words, the super project of this module, e.g. Invenio itself.

cookiecutter-invenio-module's People

Contributors

crepererum avatar jirikuncar avatar kaplun avatar

Watchers

James Cloos avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.