struct2文件上传

‘壹’ 使用 Clia Swagger Generator，在 VSCode 中从 Rust Web 接口创建文档

这是一个提高工作效率的VSCode插件，能够从使用Rust开发的后台接口，一键生成Swagger文档，然后可以导入YAPI中，快速创建接口的文档。

一、开发背景

我们为什么要开发这个VSCode插件？开发出来能够带来什么样的好处？

我们开发后台接口时，一般是先定义这个接口，在开发团队内部对接口的描述进行评审，前后端开发者取得一致的意见之后，再进行接口实际程序的开发。

这样一方面开发的接口方向不会错，另一方面前端开发者也可以第一时间针对接口描述开始进行开发工作了。

这就要求我们文档先行，先写好接口的描述文档。

以往，我们都是直接在YAPI上先进行接口文档的编写工作，取得一致意见后再进行接口的开发。

但是感觉直接在YAPI上编写接口文档，效率不是很高；而且编写好文档，已经出了一次力，然后再按照接口文档开发接口的程序，这又是出了第二次力了。能不能把这两次力合并成只出一次力呢？

于是我们想到，首先直接在程序里定义好接口，然后从程序直接生成接口文档。

这样做有以下几个好处：

程序写起来比在YAPI上写接口文档要稍快一点；

写程序时更难发生拼写错误，生成的文档也就不会有了；

详尽的文档来源于详尽的程序注释，这样会促使我们把程序注释写得完整详尽，代码更好维护一点；

导出文档需要程序有规范的接口输入输出参数的类型定义，这样会促使我们把程序也写得更规范一点；

今后对于接口有什么修改，也可以方便快速地导出到文档上面来；

二、安装插件

插件使用的演示

在VSCode插件里面直接搜索clia，应该就能看到插件“Clia Swagger Generator”了。

安装即可。

在插件的扩展设置里，有 basePath、host、schemes 三项是需要我们进行填写的。

三、编写接口

一个合适导出的Rust接口是什么样子的？

如下 Rust 代码：

use ntex::http::StatusCode;use ntex::web::types::Json;use ntex::web::{self, Error, HttpRequest, HttpResponse};use serde::{Deserialize, Serialize};/// 注册新开发者接口的请求。#[derive(Debug, Clone, Serialize, Deserialize)]pub struct RegisterDeveloperJson {/// 开发者注册邮箱pub dev_email: String,/// 开发者名称pub dev_name: String,/// 开发者类型：个人(indivial) | 企业(enterprise)pub dev_type: String,/// 开发者设定的密码pub user_password: String,}/// 注册新开发者接口的响应格式。#[derive(Debug, Clone, Serialize, Deserialize)]pub struct RegisterDeveloperResponse {/// 返回代码pub code: i32,/// 返回消息pub msg: String,/// 返回数据pub data: RegisterDeveloperData,}/// 注册新开发者接口的数据格式。#[derive(Debug, Clone, Serialize, Deserialize)]pub struct RegisterDeveloperData {/// 创建的开发者IDpub developer_id: u64,}/// 注册新开发者。////// 请求 JSON 示例：////// <pre><code>/// {/// "dev_email": "[email protected]",/// "dev_name": "Some One",/// "dev_type": "indivial",/// "user_password": "abcd1234"/// }/// </code></pre>/// /// 返回 JSON 示例：/// /// <pre><code>/// {/// "code":0,/// "msg":"success",/// "data":{/// "developer_id":2349/// }/// }/// </code></pre>////// @returns RegisterDeveloperResponse///#[web::post("/mp/register-developer")]pub async fn register_developer(req: HttpRequest,body: Json<RegisterDeveloperJson>,) -> Result<HttpResponse, Error> {log::debug!("{:?}", req);log::debug!("{:?}", body);// responseOk(HttpResponse::build(StatusCode::OK).content_type("application/json; charset=utf-8").body(r#"{"code":0,"msg":"success","data":{"developer_id":2349}}"#,))}

以上是一个实际的Rust接口程序。

需要注意以下几点：

插件是根据 #[web:: 这个来判断接口的位置的；

支持的参数类型包括：Query, Json；

插件根据注释中的 @returns 判断返回类型；

目前所有参数结构定义必须都要在这个文件里面；

四、生成Swagger

从接口定义生成Swagger文档

在接口定义下面有个“Generate Swagger”按钮，点一下就会生成出右边的 Swagger 文档来了。

在文档上点一下“Save Swagger.json”按钮，就可以保存文档，保存时自动添加时间戳。

五、 导入YAPI

最后一步，直接把生成的 Swagger 文档导入到 YAPI 中。

在 YAPI 的数据管理中，选好 Swagger 格式和要导入的目录，直接把刚才生成的 Swagger 文档拖到上传区域，就可以了。

接口文档就生成出来了。

六、后续计划

罗列待办事项

事项1：根据接口实现中的各种错误的返回值，自动生成错误代码列表

事项2：支持其他语言开发的接口，或是Rust的其他Web框架的接口

仓库地址：https://github.com/clia/swagger-generator

原文：https://juejin.cn/post/7100010294360932383

‘贰’ cmd上传命令是啥

ftp上传？
send
put

‘叁’ C语言实现从FTP下载、上传文件

FTP 是File Transfer Protocol（文件传输协议）的英文简称，而中文简称为“文传协议”。
1.C语言可以使用CStdioFile函数打开本地文件。使用类CInternetSession 创建并初始化一个Internet打开FTP服务器文件。
CStdioFile继承自CFile，一个CStdioFile 对象代表一个用运行时函数fopen 打开的C 运行时流式文件。
流式文件是被缓冲的，而且可以以文本方式（缺省）或二进制方式打开。文本方式提供对硬回车—换行符对的特殊处理。当你将一个换行符（0x0A）写入一个文本方式的CStdioFile 对象时，字节对（0x0D，0x0A）被发送给该文件。当你读一个文件时，字节对（0x0D，0x0A）被翻译为一个字节（0x0A）。
CStdioFile 不支持Duplicate，LockRange，和UnlockRange 这几个CFile 函数。如果在CStdioFile 中调用了这几个函数，将会出现CNoSupported 异常。
使用类CInternetSession 创建并初始化一个或多个同时的Internet 会话。如果需要，还可描述与代理服务器的连接。
如果Internet连接必须在应用过程中保持着，可创建一个类CWinApp的CInternetSession成员。一旦已建立起Internet 会话，就可调用OpenURL。CInternetSession会通过调用全局函数AfxParseURL来为分析映射URL。无论协议类型如何，CInternetSession 解释URL并管理它。它可处理由URL资源“file://”标志的本地文件的请求。如果传给它的名字是本地文件，OpenURL 将返回一个指向CStdioFile对象的指针。
如果使用OpenURL在Internet服务器上打开一个URL，你可从此处读取信息。如果要执行定位在服务器上的指定的服务(例如，HTTP，FTP或Gopher)行为，必须与此服务器建立适当的连接。

‘肆’ python中如何安全地进行编译和反编译

在Python中编写脚本和小程序非常便捷，但它们需要特定的Python环境才能运行。这导致了在不同电脑上运行时可能出现问题，尤其当Python版本和相关依赖库不一致时。为了解决这个问题，一种方法是利用Pyinstaller将代码、依赖库以及编译环境打包到一起，生成一个exe文件，方便跨平台运行。接下来，我们将探讨如何使用Pyinstaller来实现这一功能。

一、使用Pyinstaller打包Python代码

1. **安装Pyinstaller**：安装过程简单，在命令行中运行`pip install pyinstaller`即可完成安装。

2. **打包代码**：以一个简单的代码示例进行演示。创建一个主文件`main.py`，引入自定义库`mylib.py`，并执行特定功能。打包过程如下：

python
# mylib.py
import time

def myfunc():
now = time.time()
timetime_str = time.strftime("%Y-%m-%d %H:%M", time.localtime(now))
print('现在是' + time_str)
print("Have a nice day!")

# main.py
import mylib
import os

if __name__ == "__main__":
mylib.myfunc()
os.system('pause')

在命令行中运行`pyinstaller.exe -F yourcode.py`，执行打包操作。输出信息会显示打包过程的各个阶段，最终生成的文件会保存在指定目录下。此时，你将在当前文件夹下看到一系列文件，包括`main.exe`，这是打包完成的exe文件，直接双击即可运行。

编辑

然而，简单的打包过程引出了一个关键问题：打包后的exe文件是否安全，是否会轻易被反编译？让我们深入探讨反编译的过程。

二、反编译过程

1. **下载并使用pyinstxtractor解包**：采用pyinstxtractor.py工具将Pyinstaller生成的exe文件解包，以获取源代码。首先下载并安装pyinstxtractor，然后将其复制到待解包的exe文件同级目录下，执行命令`python pyinstxtractor.py xx.exe`，解包后会在目录中生成`xx.exe_extracted`文件夹，包含多个dll、pyd等文件，其中`xxx.exe.manifest`文件是真实名称，而一个名为`xxx`的无后缀文件则是对应的pyc文件。

2. **反编译pyc文件**：找到pyc文件后，可以使用在线工具或本地软件进行反编译。注意，直接上传可能无法反编译成功，因为文件可能缺少首部的16个字节（magic number），表示Python版本和编译时间。通过从`struct`文件中复制正确的magic number，再进行反编译，可以成功还原源代码。

通过上述步骤，我们了解到Pyinstaller生成的exe文件其实是相对容易被反编译的。那么，如何保护源码安全呢？

三、使用Pyinstaller加密打包exe

Pyinstaller本身支持加密打包，只需在打包时添加`--key`参数。例如，执行命令`pyinstaller.exe -F --key 123456 xxx.py`，这需要`pycrypto`包的支持。因此，首先确保安装了`pycrypto`，可以通过命令`pip install pycrypto`完成安装。如果遇到安装问题，可以参考StackOverflow上的解答，通过设置环境变量解决VS编译器相关问题。

总结，如果你希望保护代码安全，可以采用以下策略：将主程序功能放入单独的文件中，并使用加密打包。这样，即使他人尝试反编译exe文件，也只能获取到主程序入口，而无法访问内部的源代码。这为保护知识产权和代码安全提供了一定程度的保障。