如何使用Sphinx-Napoleon为Google风格的文档字符串指示生成器的列表,可选参数和返回类型的类型?
我试过了
List[type]
list of type
Optional[type]
type, optional
Run Code Online (Sandbox Code Playgroud)
和
Yields:
type:
Run Code Online (Sandbox Code Playgroud)
分别; 但是所有产生的输出都不令人满意,与生成的文档的其余部分不一致.例如
Optional[type]
Run Code Online (Sandbox Code Playgroud)
只是给
可选[类型]
没有任何链接type.
我尝试过每个内置主题并遇到同样的问题.
我应该如何使用Sphinx-Napoleon的Google风格文档来记录这些元素?
我对用于协议的关联类型的语法与另一方面的泛型类型之间的区别感到困惑.
例如,在Swift中,可以使用类似的东西定义泛型类型
struct Stack<T> {
var items = [T]()
mutating func push(item: T) {
items.append(item)
}
mutating func pop() -> T {
return items.removeLast()
}
}
Run Code Online (Sandbox Code Playgroud)
而一个使用类似的东西定义一个具有相关类型的协议
protocol Container {
typealias T
mutating func append(item: T)
var count: Int { get }
subscript(i: Int) -> T { get }
}
Run Code Online (Sandbox Code Playgroud)
后者为什么不是:
protocol Container<T> {
mutating func append(item: T)
var count: Int { get }
subscript(i: Int) -> T { get }
}
Run Code Online (Sandbox Code Playgroud)
是否存在一些深层次(或者可能只是显而易见并且迷失在我身上)的原因,即语言没有采用后一种语法?
Google Colab 上运行的当前默认 Python 版本是 3.7,但我的笔记本需要 3.9 才能工作。
如何将 Google Colab 的 Python 版本更新到 3.9(或更高版本)?
我不能再运行brew upgrade或brew update:两者都中止
Error: homebrew-core is a shallow clone. To `brew update` first run:
git -C "/usr/local/Homebrew/Library/Taps/homebrew/homebrew-core" fetch --unshallow
Run Code Online (Sandbox Code Playgroud)
如果我遵循此建议并运行git ... --unshallow然后尝试,brew update否则brew upgrade我仍然会收到相同的错误消息。
如果我然后再次尝试该命令(也许我第一次没有做对?)我得到
fatal: --unshallow on a complete repository does not make sense
如何绕过此错误消息以运行brew upgrade或brew update没有错误?
HOMEBREW_VERSION: 2.6.0-82-gde1afcb
ORIGIN: https://github.com/Homebrew/brew.git
HEAD: de1afcbfc58fb3cd5779bd8fbb6b9995700dda4c
Last commit: 30 hours ago
Core tap ORIGIN: https://github.com/Homebrew/homebrew-core
Core tap HEAD: a7c63b0f7f7ae416a2f961b263155281759ac3a7
Core tap last commit: 29 hours ago
Core tap …Run Code Online (Sandbox Code Playgroud) 我有一个我用Flask SQLAlchemy和SQLite构建的网站,需要切换到MySQL.我已经迁移了数据库并让它在MySQL下运行,但是
SQLALCHEMY_DATABASE_URI应该是什么)和我怀疑(1)是相当简单的,只是显示如何映射,例如,我在我的MySQL数据库工具中使用的连接对话框的内容到适当格式化的URL.但我担心(2),我曾假设SQLAlchemy提供了一个抽象层,以便简单的SQLAlchemy代码如
from flask import Flask
from flask.ext.sqlalchemy import SQLAlchemy
app = Flask(__name__)
app.config['SQLALCHEMY_DATABASE_URI'] = 'sqlite:////tmp/test.db'
db = SQLAlchemy(app)
class User(db.Model):
id = db.Column(db.Integer, primary_key=True)
username = db.Column(db.String(80), unique=True)
email = db.Column(db.String(120), unique=True)
def __init__(self, username, email):
self.username = username
self.email = email
def __repr__(self):
return '<User %r>' % self.username
admin = User('admin', 'admin@example.com')
db.session.add(admin)
User.query.all()
User.query.filter_by(username='admin').first()
Run Code Online (Sandbox Code Playgroud)
除了对数据库URI的适当更改之外,没有任何修改的工作; 但我发现使用SQLAlchemy和MySQL 的例子似乎使用了完全不同的API.
我是否可以(2)通过简单地更改数据库URI来迁移我的Flask SQLAlchemy代码以使用MySQL数据库,如果是这样(1)该URI应该是什么?
在OS X或macOS上的所有终端会话中,如果我输入who,除了预期的用户(我在不同的窗口中),我也总是看到
_mbsetupuser console ...
Run Code Online (Sandbox Code Playgroud)
只是谁是,什么是他/她在做什么?
我想对我的IPython/IHaskell/Jupyter笔记本的外观进行一些简单的修改,比如
rendered_html :link {
text-decoration: none;
}
Run Code Online (Sandbox Code Playgroud)
但我无法弄清楚如何做到这一点.我已经尝试了许多通过搜索找到的解决方案,例如,将CSS放入其中
~/.ipython/profile_default/static/css/custom.css
Run Code Online (Sandbox Code Playgroud)
但没有任何影响,我怀疑,鉴于笔记本架构最近的变化,实现这一目标的方法已经改变,我发现的指令已经过时了.
如何为我的IPython/IHaskell/Jupyter Notebook设置自定义CSS?
OS X 10.10.4; Xcode 6.4; CLT:6.4.0.0.1; Clang:6.1; Python Python 2.7.10(Homebrew); IHaskell 0.6.4.1,IPython 3.0.0(4.0.0和Jupiter 4.0的答案也很受欢迎,因为我很快就会升级).
我最近更新了IPython(到4.0)并且在一段时间之后开始使用笔记本电脑不使用它们(因为在我之前的The Big Split之前),并且发现我的一些设置需要修改并从~/.ipython/到~/.jupyter/.
例如,它似乎NotebookManager.notebook_dir在
~/.ipython/profile_default/ipython_notebook_config.py
Run Code Online (Sandbox Code Playgroud)
被忽略,并将其功能替换为 FileContentsManager.root_dir in
~/.jupyter/jupyter_notebook_config.py
Run Code Online (Sandbox Code Playgroud)
但是,除了像这样的孤立事件之外,我还不清楚配置设置和配置文件现在如何工作.特别是哪些文件应该位于哪里,以及它们应该包含什么.例如,如果我生成一个新的配置文件
ipython profile create foo
Run Code Online (Sandbox Code Playgroud)
我现在获得的文件与以前不同(并且比我现有的配置文件中的文件要多):我以前在哪里获得
ipython_config
ipython_notebook_config.py
ipython_nbconvert_config.py
Run Code Online (Sandbox Code Playgroud)
我现在明白了
ipython_config.py
ipython_kernel_config.py
Run Code Online (Sandbox Code Playgroud)
并且尽可能地说,我ipython_notebook_config.py没有使用过.
这个(以及有限的文档)让我有点困惑我应该把我的设置和配置文件放在哪里用于IPython/Jupyter 4.0,具体来说:
~/.jupyter/jupyter_notebook_config.py,但我不清楚这些是否会覆盖从其他地方加载的设置.)ipython_notebook_config.py目录中的~/.ipython/profile_someprofile/文件吗?)ipython_kernel_config.py文件;我应该删除ipython_notebook_config.py和ipython_nbconvert_config.py文件吗?)OS X 10.10.4; Xcode 6.4; CLT:6.4.0.0.1; Clang:6.1; Python Python 2.7.10(Homebrew); Jupyter 4.0.4; IPython 4.0.0.
自从最近更新 Watchman(使用 Homebrew)以来,我无法再使用它来观看项目。我明白了
{
"version": "2022.05.30.00",
"error": "std::__1::system_error: open: /Users/Path/To/Project: Operation not permitted"
}
Run Code Online (Sandbox Code Playgroud)
我最初认为这一定是我可以通过正常方式解决的文件访问问题,但让监视程序应用程序访问文件和文件夹并不能解决问题(即使终止所有监视程序进程并重新启动终端)。
为了更好地衡量,我还手动将 watchman 可执行文件添加到全磁盘访问(这是我以前从未需要做的事情,而且对此感到不舒服),但这也没有效果。
我还终止了我能想到的所有相关进程,甚至重新启动了两次。据我所知,自 Watchman 工作以来唯一的brew update watchman变化是我的跑步(当然我也卸载并重新安装)。
一个问题是,由于某种原因,我在系统偏好设置中有多个看守条目,这奇怪地导致需要数十次尝试才能将它们全部进入检查状态以进行访问:
我如何向 Watchman 授予克服此错误所需的权限?
苹果斯威夫特编程语言指南中提到的捕捉符 unowned(safe)和unowned(unsafe),除了weak和unowned.
我(想我)明白之间的差别weak和unowned; 但unowned(safe)和之间有什么区别unowned(unsafe)?指南没有说.
请:不要仅仅依赖于描述Objective-C等价物.