首页 > 编程语言 >4.25python

4.25python

时间:2023-04-28 21:34:32浏览次数:108  
标签:函数 arg2 python arg1 代码 规范 numbers 4.25

 

 

Python 编程规范主要包括代码布局、命名规范、注释规范、函数编写规范等多个方面,下面给出一些常见的编程规范及其示例代码。

1. 代码布局规范

代码布局规范主要是指代码的缩进、行宽、空行、换行等方面,下面是一些常见的代码布局规范:

  • 使用四个空格作为一个缩进级别,不要使用制表符。
  • 每行代码最多不超过 79 个字符,如果需要换行可以使用括号、\ 符号或者三个双引号。
  • 在函数之间、类之间和逻辑块之间添加一行空白行,以提高代码可读性。

示例代码:

  def my_function(arg1, arg2):
  if arg1 == 'value':
  result = arg1 + arg2
  else:
  result = arg2 - arg1
  return result

2. 命名规范

命名规范主要是指变量名、函数名、类名等的命名规则,下面是一些常见的命名规范:

  • 使用全小写的单词或下划线分隔的多个单词来命名变量或函数。
  • 类名首字母大写,采用驼峰命名法。
  • 使用前缀或后缀来命名私有变量或函数,以单下划线或双下划线开头或结尾。

示例代码:

  class MyClass:
  def __init__(self, name):
  self._name = name
  def get_name(self):
  return self._name
  def _helper_method(self):
  pass
  my_object = MyClass('John')
  print(my_object.get_name())

3. 注释规范

注释规范主要是指如何编写注释,以方便别人理解你的代码,下面是一些常见的注释规范:

  • 在代码中适当添加注释,以解释代码的目的和实现方法。
  • 给函数和类添加文档字符串,以描述其功能和参数等信息。
  • 避免使用无意义的注释,例如 “增加变量 x 的值”。

示例代码:

  # This function calculates the sum of two numbers
  def add_numbers(num1, num2):
  """
  Calculate the sum of two numbers.
  Args:
  num1: First number to add.
  num2: Second number to add.
  Returns:
  The sum of the two numbers.
  """
  return num1 + num2

python的文档字符串是什么?

Python 的文档字符串是指在模块、类、方法、函数等代码段的开头使用 """ 进行多行字符串注释来描述代码段的功能、参数、返回值等信息的规范化方式。这些文档字符串可以被工具程序提取和转换为 HTML、PDF、Unix 手册页等格式的文档,并且可以被编程编辑器、交互式帮助工具等程序自动读取和显示,对于代码的使用与维护十分有帮助。

文档字符串应该被写在代码段的开头,并包含以下部分:

  • 描述代码段的功能和用途。
  • 描述代码段的参数名称、类型、范围和意义。
  • 描述代码段的返回值类型、范围和意义。
  • 描述代码段的异常和错误处理信息。
  • 其他相关的注释和说明。

下面是一个函数的文档字符串示例:

  def my_function(arg1, arg2):
  """
  This function adds two numbers.
  Args:
  arg1 (int): The first number.
  arg2 (int): The second number.
  Returns:
  int: The sum of the two numbers.
  Raises:
  ValueError: If either input is not an int.
  Examples:
  >>> my_function(2, 3)
  5
  >>> my_function(2, "three")
  ValueError: arg2 must be an int.
  """
  if not isinstance(arg1, int) or not isinstance(arg2, int):
  raise ValueError("arg1 and arg2 must be ints.")
  return arg1 + arg2

注意,文档字符串中的参数类型和异常处理信息只是规范化的描述,实际代码中还需要进行相应的类型判断和错误处理。

4. 函数编写规范

函数编写规范主要是指如何编写函数,以方便别人阅读和使用你的代码,下面是一些常见的函数编写规范:

  • 函数应该尽可能短小,不要超过 20 行。
  • 函数应该只完成一个明确的任务,而不是多个任务。
  • 函数应该有一个明确的返回值,或者返回 None。

示例代码:

  def calc_sum(nums):
  """
  Calculate the sum of a list of numbers.
  Args:
  nums: A list of numbers to sum.
  Returns:
  The sum of the list of numbers.
  """
  total = 0
  for num in nums:
  total += num
  return total

标签:函数,arg2,python,arg1,代码,规范,numbers,4.25
From: https://www.cnblogs.com/zhaoshengfu/p/17363203.html

相关文章

  • [oeasy]python0141_自制模块_module_reusability_复用性
    自制包内容回忆上次内容上次导入了外部的py文件importmy_module导入一个自己定义的模块 可以使用my_module中的变量不能直接使用my_module.py文件中的变量只要加my_module.作为前缀就可以  直接导入导入变量、函数frommy_mo......
  • /usr/bin/env: ‘python’: No such file or directory
     01、问题 02、解决方法a、root@DESKTOP-A31BQ38:/home/software/gatk-4.4.0.0#whichpython3##确定已经安装python;或者执行whichpython,输出python可调用路径/usr/bin/python3 b、root@DESKTOP-A31BQ38:/home/software/gatk-4.4.0.0#ln-s/usr/b......
  • 【Python】【MySQL】Python将JSON数据以文本形式存放到MySQL的Text类型字段中
    1.起因在做一个自动打卡的玩意。登录会得到那个平台一系列的信息。我又不想专门修改、增加数据库字段来存放,所有打算直接将返回的JSON数据保存到一个MySQL字段中。内容肯定不能直接放,考虑下比如数据注入的问题,对吧,容易出问题,所有我是打算将JSON数据转为base64编码的格式。先写......
  • python 发邮件 图片作附件
    importsmtplibfromemail.mime.textimportMIMETextfromemail.mime.multipartimportMIMEMultipartfromemail.mime.imageimportMIMEImage#邮件发件人和收件人信息sender_email='你的Gmail地址'sender_password='你的Gmail密码'recipient_email='收......
  • python 读写sqlite3
    importsqlite3#连接到SQLite3数据库conn=sqlite3.connect('example.db')#创建一个表conn.execute('''CREATETABLEIFNOTEXISTSusers(idINTEGERPRIMARYKEYAUTOINCREMENT,nameTEXTNOTNULL,ageI......
  • 《流畅的Python》第二版上市了,值得入手么?
    《FluentPython》第一版在2015年出版,简体中文版《流畅的Python》在2017年出版。从那时起,它就成为了所有Python程序员的必读之书。如果一份面向中高级Python开发者的书单里不包含这本书,那这份书单肯定不合格!《FluentPython》第二版在2022年出版,最近,简体中文版《流畅的......
  • Python Requets库学习总结
    快速开始发送请求>>>importrequests>>>r=requests.get('https://api.github.com/events')#GET>>>r=requests.post('https://httpbin.org/post',data={'key':'value'})#POST>>>r=r......
  • Python模块之struct
    0背景在工作中,有些二进制文件,是通过结构体写入文件而形成,我们有时候想解析这些文件,那如何操作呢?python的struct模块和C语言的结构体是相对应的,这样,只要知道结构体的定义,我们就可以通过struct模块写出一些解析工具。1.strcut模块介绍class struct.Struct(format)......
  • Python Ternary Operator All In One
    PythonTernaryOperatorAllInOnePythonTernaryExpression/PythonTernaryOperatorPython三元表达式/Python三元运算符Pythonternaryoperatorerror❌importosunicode=os.path.supports_unicode_filenames;#print("\nunicode=",unicode?"......
  • python日常工作处理-文件按比例分割数据
    python日常工作处理-文件按比例分割数据把一个保存用户id文本进行比例分割,比例为50%,分别另存为另外两个文件代码importrandominput_file='/Users/Desktop/2023-03-28.txt'group1_file='/Users/Desktop/group1_2023-03-28.txt'group2_file='/Users/Desktop/group2_......