sh_cpl/docs/build/html/cpl_cli.new.html

227 lines
12 KiB
HTML
Raw Permalink Normal View History

2021-05-17 18:32:09 +02:00
<!DOCTYPE html>
<html class="writer-html5" lang="en" >
<head>
2023-04-05 21:43:21 +02:00
<meta charset="utf-8" /><meta name="generator" content="Docutils 0.19: https://docutils.sourceforge.io/" />
2022-06-27 21:42:34 +02:00
2021-05-17 18:32:09 +02:00
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>cpl new &mdash; Common Python Library documentation</title>
2022-06-27 21:42:34 +02:00
<link rel="stylesheet" href="_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="_static/css/theme.css" type="text/css" />
2021-05-17 18:32:09 +02:00
<!--[if lt IE 9]>
<script src="_static/js/html5shiv.min.js"></script>
<![endif]-->
<script src="_static/jquery.js"></script>
2022-06-27 21:42:34 +02:00
<script src="_static/_sphinx_javascript_frameworks_compat.js"></script>
2023-04-05 21:43:21 +02:00
<script data-url_root="./" id="documentation_options" src="_static/documentation_options.js"></script>
2021-05-17 18:32:09 +02:00
<script src="_static/doctools.js"></script>
2023-04-05 21:43:21 +02:00
<script src="_static/sphinx_highlight.js"></script>
2022-06-27 21:42:34 +02:00
<script src="_static/js/theme.js"></script>
2021-05-17 18:32:09 +02:00
<link rel="index" title="Index" href="genindex.html" />
<link rel="search" title="Search" href="search.html" />
2023-02-20 15:55:20 +01:00
<link rel="next" title="cpl publish" href="cpl_cli.publish.html" />
<link rel="prev" title="cpl install" href="cpl_cli.install.html" />
2021-05-17 18:32:09 +02:00
</head>
2022-06-27 21:42:34 +02:00
<body class="wy-body-for-nav">
2021-05-17 18:32:09 +02:00
<div class="wy-grid-for-nav">
<nav data-toggle="wy-nav-shift" class="wy-nav-side">
<div class="wy-side-scroll">
<div class="wy-side-nav-search" >
2023-04-05 21:43:21 +02:00
<a href="index.html" class="icon icon-home">
Common Python Library
2021-05-17 18:32:09 +02:00
</a>
<div role="search">
<form id="rtd-search-form" class="wy-form" action="search.html" method="get">
2023-04-05 21:43:21 +02:00
<input type="text" name="q" placeholder="Search docs" aria-label="Search docs" />
2021-05-17 18:32:09 +02:00
<input type="hidden" name="check_keywords" value="yes" />
<input type="hidden" name="area" value="default" />
</form>
</div>
2022-06-27 21:42:34 +02:00
</div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
2021-05-17 18:32:09 +02:00
<ul class="current">
<li class="toctree-l1"><a class="reference internal" href="introduction.html">Introduction to the CPL Docs</a></li>
<li class="toctree-l1"><a class="reference internal" href="getting_started.html">Getting started</a></li>
2022-07-31 11:30:05 +02:00
<li class="toctree-l1"><a class="reference internal" href="contributing.html">Contributing to CPL</a></li>
2023-04-05 21:43:21 +02:00
<li class="toctree-l1"><a class="reference internal" href="deprecated.html">Deprecated</a></li>
2022-12-04 00:50:24 +01:00
<li class="toctree-l1 current"><a class="reference internal" href="cpl_cli.html">CLI reference</a><ul class="current">
2023-02-20 15:55:20 +01:00
<li class="toctree-l2"><a class="reference internal" href="cpl_cli.overview.html">CLI Overview and Command Reference</a></li>
<li class="toctree-l2"><a class="reference internal" href="cpl_cli.add.html">cpl add</a></li>
<li class="toctree-l2"><a class="reference internal" href="cpl_cli.build.html">cpl build</a></li>
<li class="toctree-l2"><a class="reference internal" href="cpl_cli.generate.html">cpl generate</a></li>
<li class="toctree-l2"><a class="reference internal" href="cpl_cli.help.html">cpl help</a></li>
<li class="toctree-l2"><a class="reference internal" href="cpl_cli.install.html">cpl install</a></li>
2021-05-17 18:32:09 +02:00
<li class="toctree-l2 current"><a class="current reference internal" href="#">cpl new</a><ul>
<li class="toctree-l3"><a class="reference internal" href="#contents">Contents</a></li>
<li class="toctree-l3"><a class="reference internal" href="#description">Description</a></li>
<li class="toctree-l3"><a class="reference internal" href="#project-types">Project types</a></li>
2022-06-27 21:42:34 +02:00
<li class="toctree-l3"><a class="reference internal" href="#flags">Flags</a></li>
2021-05-17 18:32:09 +02:00
</ul>
</li>
2023-02-20 15:55:20 +01:00
<li class="toctree-l2"><a class="reference internal" href="cpl_cli.publish.html">cpl publish</a></li>
<li class="toctree-l2"><a class="reference internal" href="cpl_cli.remove.html">cpl remove</a></li>
<li class="toctree-l2"><a class="reference internal" href="cpl_cli.run.html">cpl run</a></li>
<li class="toctree-l2"><a class="reference internal" href="cpl_cli.start.html">cpl start</a></li>
<li class="toctree-l2"><a class="reference internal" href="cpl_cli.uninstall.html">cpl uninstall</a></li>
<li class="toctree-l2"><a class="reference internal" href="cpl_cli.update.html">cpl update</a></li>
<li class="toctree-l2"><a class="reference internal" href="cpl_cli.version.html">cpl version</a></li>
2021-05-17 18:32:09 +02:00
</ul>
</li>
2022-12-04 00:50:24 +01:00
<li class="toctree-l1"><a class="reference internal" href="cpl_core.html">API reference</a></li>
2023-04-04 13:16:19 +02:00
<li class="toctree-l1"><a class="reference internal" href="cpl_discord.html">Discord Reference</a></li>
2022-12-04 00:50:24 +01:00
<li class="toctree-l1"><a class="reference internal" href="cpl_query.html">Query reference</a></li>
<li class="toctree-l1"><a class="reference internal" href="cpl_translation.html">Translation reference</a></li>
2021-05-17 18:32:09 +02:00
</ul>
</div>
</div>
</nav>
2022-06-27 21:42:34 +02:00
<section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"><nav class="wy-nav-top" aria-label="Mobile navigation menu" >
2021-05-17 18:32:09 +02:00
<i data-toggle="wy-nav-top" class="fa fa-bars"></i>
<a href="index.html">Common Python Library</a>
</nav>
<div class="wy-nav-content">
<div class="rst-content">
2022-06-27 21:42:34 +02:00
<div role="navigation" aria-label="Page navigation">
2021-05-17 18:32:09 +02:00
<ul class="wy-breadcrumbs">
2023-04-05 21:43:21 +02:00
<li><a href="index.html" class="icon icon-home" aria-label="Home"></a></li>
<li class="breadcrumb-item"><a href="cpl_cli.html">CLI reference</a></li>
<li class="breadcrumb-item active">cpl new</li>
2021-05-17 18:32:09 +02:00
<li class="wy-breadcrumbs-aside">
2023-02-20 15:55:20 +01:00
<a href="_sources/cpl_cli.new.md.txt" rel="nofollow"> View page source</a>
2021-05-17 18:32:09 +02:00
</li>
</ul>
<hr/>
</div>
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
<div itemprop="articleBody">
2022-06-27 21:42:34 +02:00
<section id="cpl-new">
<h1>cpl new<a class="headerlink" href="#cpl-new" title="Permalink to this heading"></a></h1>
<section id="contents">
<h2>Contents<a class="headerlink" href="#contents" title="Permalink to this heading"></a></h2>
2021-05-17 18:32:09 +02:00
<ul class="simple">
2023-04-05 21:43:21 +02:00
<li><p><a class="reference internal" href="cpl_discord.container.html#cpl_discord.container.guild.Guild.description" title="cpl_discord.container.guild.Guild.description"><span class="xref myst py py-attr">Description</span></a></p></li>
<li><p><a class="reference internal" href="cpl_core.configuration.html#cpl_core.configuration.configuration.Configuration.arguments" title="cpl_core.configuration.configuration.Configuration.arguments"><span class="xref myst py py-attr">Arguments</span></a></p></li>
<li><p><a class="reference internal" href="#project-types"><span class="xref myst">Project types</span></a></p></li>
2021-05-17 18:32:09 +02:00
</ul>
<p>Generates a workspace and initial project or add a project to workspace.</p>
<p>cpl <strong>new</strong> <em>&lt;type&gt;</em> <em>&lt;name&gt;</em><br>
cpl <strong>n</strong> <em>&lt;type&gt;</em> <em>&lt;name&gt;</em> <br>
cpl <strong>N</strong> <em>&lt;type&gt;</em> <em>&lt;name&gt;</em></p>
2022-06-27 21:42:34 +02:00
</section>
<section id="description">
<h2>Description<a class="headerlink" href="#description" title="Permalink to this heading"></a></h2>
2021-05-17 18:32:09 +02:00
<p>Generates a workspace and initial project or add a project to workspace.</p>
2022-12-08 15:29:48 +01:00
<p>You can define custom project types by creating templates in a <code class="docutils literal notranslate"><span class="pre">.cpl</span></code> folder.</p>
2021-05-17 18:32:09 +02:00
<p>If the command is running in a CPL workspace, it will add the new project to the workspace.</p>
2023-04-05 21:43:21 +02:00
<table class="docutils align-default">
2021-05-17 18:32:09 +02:00
<thead>
<tr class="row-odd"><th class="head"><p>Argument</p></th>
2023-04-05 21:43:21 +02:00
<th class="head text-center"><p>Description</p></th>
<th class="head text-center"><p>Value type</p></th>
2021-05-17 18:32:09 +02:00
</tr>
</thead>
<tbody>
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">&lt;type&gt;</span></code></p></td>
2023-04-05 21:43:21 +02:00
<td class="text-center"><p>The type of the project, see <a class="reference internal" href="#project-types"><span class="xref myst">types</span></a></p></td>
2022-06-27 21:42:34 +02:00
<td class="text-center"><p><code class="docutils literal notranslate"><span class="pre">str</span></code></p></td>
2021-05-17 18:32:09 +02:00
</tr>
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">&lt;name&gt;</span></code></p></td>
2022-06-27 21:42:34 +02:00
<td class="text-center"><p>The name of the project</p></td>
<td class="text-center"><p><code class="docutils literal notranslate"><span class="pre">str</span></code></p></td>
2021-05-17 18:32:09 +02:00
</tr>
2022-12-04 00:50:24 +01:00
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">--base</span></code></p></td>
<td class="text-center"><p>First element of path will be used as base-path not src. For example: cpl g c test/Test will be created at <code class="docutils literal notranslate"><span class="pre">src/test/</span></code> with base it would be <code class="docutils literal notranslate"><span class="pre">test/</span></code></p></td>
<td class="text-center"><p><code class="docutils literal notranslate"><span class="pre">str</span></code></p></td>
</tr>
2021-05-17 18:32:09 +02:00
</tbody>
</table>
2022-06-27 21:42:34 +02:00
</section>
<section id="project-types">
<h2>Project types<a class="headerlink" href="#project-types" title="Permalink to this heading"></a></h2>
2023-04-05 21:43:21 +02:00
<table class="docutils align-default">
2021-05-17 18:32:09 +02:00
<thead>
<tr class="row-odd"><th class="head"><p>Project type</p></th>
2023-04-05 21:43:21 +02:00
<th class="head text-center"><p>Description</p></th>
2021-05-17 18:32:09 +02:00
</tr>
</thead>
<tbody>
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">console</span></code></p></td>
2022-06-27 21:42:34 +02:00
<td class="text-center"><p>A simple console application</p></td>
2021-05-17 18:32:09 +02:00
</tr>
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">library</span></code></p></td>
2022-06-27 21:42:34 +02:00
<td class="text-center"><p>A package</p></td>
2021-05-17 18:32:09 +02:00
</tr>
</tbody>
</table>
2022-06-27 21:42:34 +02:00
</section>
<section id="flags">
<h2>Flags<a class="headerlink" href="#flags" title="Permalink to this heading"></a></h2>
2023-04-05 21:43:21 +02:00
<table class="docutils align-default">
2022-06-27 21:42:34 +02:00
<thead>
<tr class="row-odd"><th class="head"><p>Argument</p></th>
2023-04-05 21:43:21 +02:00
<th class="head text-center"><p>Description</p></th>
2022-06-27 21:42:34 +02:00
</tr>
</thead>
<tbody>
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">--async</span></code></p></td>
<td class="text-center"><p>Specifies whether async is used</p></td>
</tr>
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">--application-base</span></code></p></td>
<td class="text-center"><p>Specifies whether application base is used</p></td>
</tr>
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">--startup</span></code></p></td>
<td class="text-center"><p>Specifies whether startup is used</p></td>
</tr>
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">--service-providing</span></code></p></td>
<td class="text-center"><p>Specifies whether service-providing is used</p></td>
</tr>
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">--nothing</span></code></p></td>
<td class="text-center"><p>Specifies whether nothing is used</p></td>
</tr>
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">--venv</span></code></p></td>
<td class="text-center"><p>Specifies whether venv is used</p></td>
</tr>
</tbody>
</table>
</section>
</section>
2021-05-17 18:32:09 +02:00
</div>
</div>
2022-06-27 21:42:34 +02:00
<footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
2023-02-20 15:55:20 +01:00
<a href="cpl_cli.install.html" class="btn btn-neutral float-left" title="cpl install" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
<a href="cpl_cli.publish.html" class="btn btn-neutral float-right" title="cpl publish" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
2021-05-17 18:32:09 +02:00
</div>
<hr/>
<div role="contentinfo">
2022-12-04 00:50:24 +01:00
<p>&#169; Copyright 2021 - 2023, Sven Heidemann.</p>
2021-12-02 08:20:38 +01:00
</div>
2022-06-27 21:42:34 +02:00
Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a
2021-05-17 18:32:09 +02:00
<a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a>
2022-06-27 21:42:34 +02:00
provided by <a href="https://readthedocs.org">Read the Docs</a>.
2021-05-17 18:32:09 +02:00
</footer>
</div>
</div>
</section>
</div>
2022-06-27 21:42:34 +02:00
<script>
2021-05-17 18:32:09 +02:00
jQuery(function () {
SphinxRtdTheme.Navigation.enable(true);
});
2022-06-27 21:42:34 +02:00
</script>
2021-05-17 18:32:09 +02:00
</body>
</html>