小编nil*_*ltz的帖子

我有一些带有一些文档的服务,但是当我尝试使用grunt-ngdocs构建文档时,它失败了:

Warning: Don't know how to format @ngdoc: method Use --force to continue.

这是我想要做的

(function(angular) {
    'use strict';

    angular.module('services.base64', [])
    .factory(
            'Base64',
            [function() {

                /**
                 * @ngdoc service
                 * @name Base64
                 * @module services.base64
                 * @description Provides encoding a string into base64, and decode base64 to a string
                 */
                return {
                    /**
                     * @ngdoc method
                     * @name Base64#encode
                     * @param {string}
                     *            input the string you want to encode as base64
                     * @returns {string} the base64 encoded string
                     */
                    encode …

我有两个 python 包。一种是 util 库，一种是将使用 util 库的应用程序（最终我将有更多应用程序共享该库。

path我对两者都使用诗歌，并且应用程序使用和属性将公共库指定为依赖项develop。

例如，我的布局看起来像这样：

- common/
   - common/
      - __init__.py
      - py.typed
   - pyproject.toml

- myapp/
   - myapp/
      - __init__.py
      - py.typed
   - pyproject.toml

看起来myapp\pyproject.toml像这样：

[tool.poetry]
name = "myapp"
version = "0.1.0"
description = ""
authors = ["Your Name <you@example.com>"]

[tool.poetry.dependencies]
python = "^3.9"
common = { path = "../common", develop = true }

[tool.poetry.dev-dependencies]
mypy = "^0.910"
flake8 = "^4.0.1"
black = {version = "^21.12b0", allow-prereleases = true}
pytest …