Merge pull request #4 from geoffw0/swiftdoc3

Swift: Add Swift to supported-frameworks.rst, supported-versions-compilers.rst and extractors.rst

Author: geoffw0

docs/codeql/reusables/extractors.rst

@@ -17,4 +17,6 @@
    * - Python
      - ``python``
    * - Ruby
-     - ``ruby``
+     - ``ruby``
+   * - Swift
+     - ``swift``

docs/codeql/reusables/supported-frameworks.rst

@@ -278,3 +278,34 @@ and the CodeQL library pack ``codeql/ruby-all`` (`changelog <https://github.com/
    Ruby on Rails, Web framework
    rubyzip, Compression library
    typhoeus, HTTP client
+
+Swift built-in support
+================================
+
+.. include:: ../reusables/swift-beta-note.rst
+
+Provided by the current versions of the
+CodeQL query pack ``codeql/swift-queries`` (`changelog <https://github.com/github/codeql/tree/codeql-cli/latest/swift/ql/src/CHANGELOG.md>`__, `source <https://github.com/github/codeql/tree/codeql-cli/latest/swift/ql/src>`__)
+and the CodeQL library pack ``codeql/swift-all`` (`changelog <https://github.com/github/codeql/tree/codeql-cli/latest/swift/ql/lib/CHANGELOG.md>`__, `source <https://github.com/github/codeql/tree/codeql-cli/latest/swift/ql/lib>`__).
+
+.. csv-table::
+   :header-rows: 1
+   :class: fullWidthTable
+   :widths: auto
+
+   Name, Category
+   `AEXML <https://github.com/tadija/AEXML>`__, XML processing library
+   `Alamofire <https://github.com/Alamofire/Alamofire>`__, Network communicator
+   `Core Data <https://developer.apple.com/documentation/coredata/>`__, Database
+   `CryptoKit <https://developer.apple.com/documentation/cryptokit/>`__, Cryptography library
+   `CryptoSwift <https://github.com/krzyzanowskim/CryptoSwift>`__, Cryptography library
+   `Foundation <https://developer.apple.com/documentation/foundation>`__, Utility library
+   `GRDB <https://github.com/groue/GRDB.swift>`__, Database
+   `JavaScriptCore <https://developer.apple.com/documentation/javascriptcore>`__, Scripting library
+   `Libxml2 <https://gitlab.gnome.org/GNOME/libxml2>`__, XML processing library
+   `Network <https://developer.apple.com/documentation/network>`__, Network communicator
+   `Realm Swift <https://realm.io/realm-swift/>`__, Database
+   `RNCryptor <https://github.com/RNCryptor/RNCryptor>`__, Cryptography library
+   `SQLite3 <https://sqlite.org/index.html>`__, Database
+   `SQLite.swift <https://github.com/stephencelis/SQLite.swift>`__, Database
+   `WebKit <https://developer.apple.com/documentation/webkit>`__, User interface library

docs/codeql/reusables/supported-versions-compilers.rst

@@ -24,7 +24,8 @@
    JavaScript,ECMAScript 2022 or lower,Not applicable,"``.js``, ``.jsx``, ``.mjs``, ``.es``, ``.es6``, ``.htm``, ``.html``, ``.xhtm``, ``.xhtml``, ``.vue``, ``.hbs``, ``.ejs``, ``.njk``, ``.json``, ``.yaml``, ``.yml``, ``.raml``, ``.xml`` [7]_"
    Python [8]_,"2.7, 3.5, 3.6, 3.7, 3.8, 3.9, 3.10, 3.11",Not applicable,``.py``
    Ruby [9]_,"up to 3.2",Not applicable,"``.rb``, ``.erb``, ``.gemspec``, ``Gemfile``"
-   TypeScript [10]_,"2.6-5.0",Standard TypeScript compiler,"``.ts``, ``.tsx``, ``.mts``, ``.cts``"
+   Swift [10]_,"Swift 5.4-5.7","Swift compiler","``.swift``"
+   TypeScript [11]_,"2.6-5.0",Standard TypeScript compiler,"``.ts``, ``.tsx``, ``.mts``, ``.cts``"
 
 .. container:: footnote-group
 
@@ -37,4 +38,5 @@
     .. [7] JSX and Flow code, YAML, JSON, HTML, and XML files may also be analyzed with JavaScript files.
     .. [8] The extractor requires Python 3 to run. To analyze Python 2.7 you should install both versions of Python.
     .. [9] Requires glibc 2.17.
-    .. [10] TypeScript analysis is performed by running the JavaScript extractor with TypeScript enabled. This is the default.
+    .. [10] Swift support is currently in beta. Support for the analysis of Swift 5.4-5.7 requires macOS. Swift 5.7.3 can also be analyzed using Linux.
+    .. [11] TypeScript analysis is performed by running the JavaScript extractor with TypeScript enabled. This is the default.