commoncode/src/commoncode/version.py at main · aboutcode-org/commoncode · GitHub

History

283 lines (233 loc) · 9.86 KB

Raw

100

101

102

103

104

105

106

107

108

109

110

111

112

113

114

115

116

117

118

119

120

121

122

123

124

125

126

127

128

129

130

131

132

133

134

135

136

137

138

139

140

141

142

143

144

145

146

147

148

149

150

151

152

153

154

155

156

157

158

159

160

161

162

163

164

165

166

167

168

169

170

171

172

173

174

175

176

177

178

179

180

181

182

183

184

185

186

187

188

189

190

191

192

193

194

195

196

197

198

199

200

201

202

203

204

205

206

207

208

209

210

211

212

213

214

215

216

217

218

219

220

221

222

223

224

225

226

227

228

229

230

231

232

233

234

235

236

237

238

239

240

241

242

243

244

245

246

247

248

249

250

251

252

253

254

255

256

257

258

259

260

261

262

263

264

265

266

267

268

269

270

271

272

273

274

275

276

277

278

279

280

281

282

283

# SPDX-License-Identifier: Apache-2.0

# See http://www.apache.org/licenses/LICENSE-2.0 for the license text.

# See https://github.com/aboutcode-org/commoncode for support or download.

# See https://aboutcode.org for more information about nexB OSS projects.

import re

from collections import namedtuple

from os import path

def VERSION_PATTERNS_REGEX():

return [

re.compile(x)

for x in [

# Eclipse features

r"v\d+\.feature\_(\d+\.){1,3}\d+",

# Common version patterns

r"(M?(v\d+(\-|\_))?\d+\.){1,3}\d+[A-Za-z0-9]*((\.|\-|_|~)"

r"(b|B|rc|r|v|RC|alpha|beta|BETA|M|m|pre|vm|G)?\d+((\-|\.)\d+)?)?"

r"((\.|\-)(((alpha|dev|beta|rc|FINAL|final|pre)(\-|\_)\d+[A-Za-z]?"

r"(\-RELEASE)?)|alpha|dev(\.\d+\.\d+)?"

r"[A-Za-z]?(\d+\_){1,3}\d+\_?[A-Za-z]{0,2}\d+",

r"(b|rc|r|v|RC|alpha|beta|BETA|M|m|pre|revision-)\d+(\-\d+)?",

r"current|previous|latest|alpha|beta",

r"\d{4}-\d{2}-\d{2}",

r"(\d(\-|\_)){1,2}\d",

r"\d{5,14}",

]

def hint(path):

"""

Return a version found in a ``path`` or None. Prefix the version with 'v ' if

the version does not start with v.

"""

for pattern in VERSION_PATTERNS_REGEX():

segments = path.split("/")

# skip the first path segment unless there's only one segment

first_segment = 1 if len(segments) > 1 else 0

interesting_segments = segments[first_segment:]

# we iterate backwards from the end of the paths segments list

for segment in interesting_segments[::-1]:

version = re.search(pattern, segment)

if version:

v = version.group(0)

# prefix with v space

if not v.lower().startswith("v"):

v = f"v {v}"

return v

def is_dot_num(s):

"""

Return True if a version string `s` is semver-like and composed only of dots

and numbers.

"""

return s.strip(".0123456789") == "" and not s.startswith(".") and not s.endswith(".")

common_version_suffixes = (

"final",

"release",

"snapshot",

"jre",

"android",

"pre",

"alpha",

"beta",

"rc",

)

common_dash_version_suffixes = tuple(f"-{s}" for s in common_version_suffixes)

def is_moslty_num(s):

"""

Return True if a version string `s` is primarily composed only of dots and

numbers, with a minority of letters.

>>> is_moslty_num("v11r2")

True

"""

dot_segments = s.split(".")

len_alpha = 0

len_digit = 0

first_seg = dot_segments[0].lstrip("vV")

starts_with_digit = first_seg.isdigit()

for dot_seg in dot_segments:

dot_seg = dot_seg.lstrip("vV")

for seg in re.split("([0-9]+|[a-zA-Z]+)", dot_seg):

if seg.isdigit():

len_digit += len(seg)

elif seg.isalpha() and seg.lower() not in common_version_suffixes:

len_alpha += len(seg)

if not len_alpha and not len_digit:

return False

if not len_alpha:

return True

# we want twice more digits than alphas

if (2 * len_alpha) < len_digit:

return True

if starts_with_digit and len_alpha < len_digit:

return True

return False

NameVersion = namedtuple("NameVersion", "name, version")

def get_jar_nv(filename):

"""

Return a NameVersion tuple parsed from the JAR `filename` or None.

For example::

>>> get_jar_nv('org.eclipse.persistence.antlr_3.2.0.v201302191141.jar')

NameVersion(name='org.eclipse.persistence.antlr', version='3.2.0.v201302191141')

>>> get_jar_nv('org.eclipse.persistence.antlr.jar')

NameVersion(name='org.eclipse.persistence.antlr', version=None)

>>> get_jar_nv('org.eclipse.persistence.core_2.4.2.v20130514-5956486.jar')

NameVersion(name='org.eclipse.persistence.core', version='2.4.2.v20130514-5956486')

>>> get_jar_nv('com.io7m.jareas.checkstyle-0.2.2.jar')

NameVersion(name='com.io7m.jareas.checkstyle', version='0.2.2')

>>> get_jar_nv('ant-contrib-1.0b3.jar')

NameVersion(name='ant-contrib', version='1.0b3')

>>> get_jar_nv('xpp3-1.1.3.4.C.jar')

NameVersion(name='xpp3', version='1.1.3.4.C')

>>> get_jar_nv('ojdbc6_v11r2.jar')

NameVersion(name='ojdbc6', version='v11r2')

>>> get_jar_nv('amazon-sqs-java-messaging-lib-1.0.8.jar')

NameVersion(name='amazon-sqs-java-messaging-lib', version='1.0.8')

>>> get_jar_nv('annotations-4.1.1.4.jar')

NameVersion(name='annotations', version='4.1.1.4')

>>> get_jar_nv('aws-swf-build-tools-1.10.jar')

NameVersion(name='aws-swf-build-tools', version='1.10')

>>> get_jar_nv('c3p0-0.9.1.1.jar')

NameVersion(name='c3p0', version='0.9.1.1')

>>> get_jar_nv('javax.persistence_2.0.5.v201212031355.jar')

NameVersion(name='javax.persistence', version='2.0.5.v201212031355')

>>> get_jar_nv('proto-google-cloud-pubsub-v1-1.95.4.jar')

NameVersion(name='proto-google-cloud-pubsub-v1', version='1.95.4')

>>> get_jar_nv('xpp3-1.1.4c.jar')

NameVersion(name='xpp3', version='1.1.4c')

>>> get_jar_nv('listenablefuture-9999.0-empty-to-avoid-conflict-with-guava.jar')

NameVersion(name='listenablefuture-9999.0-empty-to-avoid-conflict-with-guava', version=None)

>>> get_jar_nv('aspectjweaver.jar')

NameVersion(name='aspectjweaver', version=None)

>>> get_jar_nv('flyway-client.jar')

NameVersion(name='flyway-client', version=None)

>>> get_jar_nv('jakarta.xml.bind-api.jar')

NameVersion(name='jakarta.xml.bind-api', version=None)

>>> get_jar_nv('javax.enterprise.concurrent.jar')

NameVersion(name='javax.enterprise.concurrent', version=None)

>>> get_jar_nv('netty-codec-http-4.1.53.Final.jar')

NameVersion(name='netty-codec-http', version='4.1.53.Final')

>>> get_jar_nv('spring-context-3.0.7.RELEASE.jar')

NameVersion(name='spring-context', version='3.0.7.RELEASE')

>>> get_jar_nv('guava-30.1-jre.jar')

NameVersion(name='guava', version='30.1-jre')

>>> get_jar_nv('guava-30.1.1-android.jar')

NameVersion(name='guava', version='30.1.1-android')

>>> get_jar_nv('guava-30.1.1-android.foo')

"""

if not filename.endswith(".jar"):

return

basename, _extension = path.splitext(filename)

# JAR name/version come in many flavors

# amazon-sqs-java-messaging-lib-1.0.8.jar is a plain name-ver

if "_" in basename:

# org.eclipse.persistence.antlr_3.2.0.v201302191141.jar

name, _, version = basename.rpartition("_")

if (

is_dot_num(version)

or is_moslty_num(version)

or version.lower().endswith(common_version_suffixes)

return NameVersion(name, version)

if "-" in basename:

# amazon-sqs-java-messaging-lib-1.0.8.jar

dashname = basename

suffix = ""

for cs in common_dash_version_suffixes:

if dashname.endswith(cs):

dashname, _, suff = dashname.rpartition("-")

suffix = f"-{suff}"

break

name, _, version = dashname.rpartition("-")

if (

is_dot_num(version)

or is_moslty_num(version)

or version.lower().endswith(common_version_suffixes)

return NameVersion(name, f"{version}{suffix}")

# no dash, no underscore means no version: org.eclipse.persistence.antlr.jar

return NameVersion(basename, None)

def get_nupkg_nv(filename):

"""

Return a NameVersion tuple parsed from the .nupkg NuGet archive `filename`.

For example (taken from

https://stackoverflow.com/questions/51662737/regex-to-parse-package-name-and-version-number-from-nuget-package-filenames/51662926):

>>> get_nupkg_nv('knockoutjs.3.4.2.nupkg')

NameVersion(name='knockoutjs', version='3.4.2')

>>> get_nupkg_nv('log4net.2.0.8.nupkg')

NameVersion(name='log4net', version='2.0.8')

>>> get_nupkg_nv('runtime.tizen.4.0.0-armel.microsoft.netcore.jit.2.0.0.nupkg')

NameVersion(name='runtime.tizen.4.0.0-armel.microsoft.netcore.jit', version='2.0.0')

>>> get_nupkg_nv('nuget.core.2.7.0-alpha.nupkg')

NameVersion(name='nuget.core', version='2.7.0-alpha')

>>> get_nupkg_nv('microsoft.identitymodel.6.1.7600.16394.nupkg')

NameVersion(name='microsoft.identitymodel', version='6.1.7600.16394')

>>> get_nupkg_nv('guava.30.1.1.foo')

"""

if not filename.endswith(".nupkg"):

return

basename, _extension = path.splitext(filename)

# Either the last 3 or 4 segments are all digits in which case this is the

# version. Otherwise we consider as version anything after the first all

# digit segment starting from left.

dot_segments = basename.split(".")

len_dot_segments = len(dot_segments)

if len_dot_segments > 4 and all(s.isdigit() for s in dot_segments[-4:]):

names = dot_segments[:-4]

versions = dot_segments[-4:]

return NameVersion(".".join(names), ".".join(versions))

if len_dot_segments > 3 and all(s.isdigit() for s in dot_segments[-3:]):

names = dot_segments[:-3]

versions = dot_segments[-3:]

return NameVersion(".".join(names), ".".join(versions))

names = []

versions = []

in_version = False

for seg in dot_segments:

if in_version:

versions.append(seg)

continue

if not seg.isdigit():

names.append(seg)

else:

versions.append(seg)

in_version = True

return NameVersion(".".join(names), ".".join(versions))

commoncode/src/commoncode/version.py at main · aboutcode-org/commoncode · GitHub

Uh oh!

Uh oh!

commoncode/src/commoncode/version.py at main · aboutcode-org/commoncode · GitHub

Uh oh!

Uh oh!

Expand file tree

Breadcrumbs

version.py

Latest commit

History

Breadcrumbs

version.py

File metadata and controls