glpkg 1.3.0__py3-none-any.whl → 1.4.0__py3-none-any.whl

gitlab/__init__.py

@@ -2,4 +2,4 @@
 
 from gitlab.packages import Packages
 
-__version__ = "1.3.0"
+__version__ = "1.4.0"

gitlab/cli_handler.py

@@ -40,6 +40,13 @@ class CLIHandler:
             name="upload", description="Uploads file to a specific package version."
         )
         self._register_upload_parser(upload_parser)
+        delete_parser = subparsers.add_parser(
+            name="delete",
+            description="Deletes a specific package version or a specific file from "
+            "a specific package version, depending whether the --file argument is "
+            "set or not.",
+        )
+        self._register_delete_parser(delete_parser)
         self.args = parser.parse_args()
 
     def _print_version(self, _args: argparse.Namespace) -> int:
@@ -240,16 +247,16 @@ class CLIHandler:
         host, project, name, token_user, token = self._args(args)
         version = args.version
         destination = args.destination
-        gitlab = Packages(host, token_user, token)
-        package_id = gitlab.get_package_id(project, name, version)
+        packages = Packages(host, token_user, token)
+        package_id = packages.get_id(project, name, version)
         if package_id:
             files = []
             if args.file:
                 files.append(args.file)
             else:
-                files = gitlab.list_files(project, package_id)
+                files = packages.get_files(project, package_id).keys()
             for file in files:
-                ret = gitlab.download_file(project, name, version, file, destination)
+                ret = packages.download_file(project, name, version, file, destination)
                 if ret:
                     print("Failed to download file " + file)
                     break
@@ -287,10 +294,10 @@ class CLIHandler:
             Zero if everything goes well, non-zero otherwise
         """
         host, project, name, token_user, token = self._args(args)
-        gitlab = Packages(host, token_user, token)
-        packages = gitlab.list_packages(project, name)
+        packages = Packages(host, token_user, token)
+        package_list = packages.get_versions(project, name)
         print("Name" + "\t\t" + "Version")
-        for package in packages:
+        for package in package_list:
             print(package["name"] + "\t" + package["version"])
 
     def _register_upload_parser(self, parser: argparse.ArgumentParser):
@@ -356,6 +363,57 @@ class CLIHandler:
                 print("File " + file + " does not exist!")
                 ret = 1
         if not ret:
-            gitlab = Packages(host, token_user, token)
-            ret = gitlab.upload_file(project, name, version, file, source)
+            packages = Packages(host, token_user, token)
+            ret = packages.upload_file(project, name, version, file, source)
+        return ret
+
+    def _register_delete_parser(self, parser: argparse.ArgumentParser):
+        """
+        Registers the delete command related arguments to the parser:
+            - version
+            - file
+            - action
+
+        Additionally, registers the common args.
+
+        Parameters
+        ----------
+        parser:
+            The argparser where to register the upload arguments.
+        """
+        self._register_common_arguments(parser)
+        parser.add_argument("-v", "--version", type=str, help="The package version.")
+        parser.add_argument(
+            "-f",
+            "--file",
+            type=str,
+            help="The file to be deleted, for example my_file.txt. Note that "
+            "only relative paths (to the package root) are supported. If undefined, "
+            "the package version is deleted.",
+        )
+        parser.set_defaults(action=self._delete)
+
+    def _delete(self, args: argparse.Namespace) -> int:
+        """
+        Deletes a file from a GitLab generic package
+
+        Parameters
+        ----------
+        args : argparse.Namespace
+            The arguments from command line
+
+        Returns
+        -------
+        int
+            Zero if everything went fine, non-zero otherwise.
+        """
+        ret = 0
+        host, project, name, token_user, token = self._args(args)
+        version = args.version
+        file = args.file
+        packages = Packages(host, token_user, token)
+        if file:
+            ret = packages.delete_file(project, name, version, file)
+        else:
+            ret = packages.delete_package(project, name, version)
         return ret

gitlab/packages.py

@@ -15,7 +15,7 @@ class Packages:
 
     def __init__(self, host: str, token_type: str, token: str):
         """
-        Creates a new instance of Packages class.
+        Creates a new instance of class.
 
         Parameters
         ----------
@@ -37,7 +37,7 @@ class Packages:
         self.token_type = token_type
         self.token = token
 
-    def api_url(self) -> str:
+    def _url(self) -> str:
         """
         Returns the GitLab REST API URL by using the host variable.
 
@@ -48,25 +48,7 @@ class Packages:
         """
         return f"https://{self.host}/api/v4/"
 
-    def project_api_url(self, project: str) -> str:
-        """
-        Returns the project REST API URL of the project
-
-        Parameters
-        ----------
-        project : str
-            The project ID or the path of the project, including namespace.
-            Examples: `123` or `namespace/project`.
-
-        Returns
-        -------
-        str
-            The project REST API URL, for example `https://gitlab.com/api/v4/projects/123/`
-            or `https://gitlab.com/api/v4/projects/namespace%2Fproject/`
-        """
-        return f"{self.api_url()}projects/{parse.quote_plus(project)}/"
-
-    def get_headers(self) -> dict:
+    def _get_headers(self) -> dict:
         """
         Creates headers for a GitLab REST API call.
 
@@ -83,98 +65,145 @@ class Packages:
             headers = {self.token_type: self.token}
         return headers
 
-    def _request(self, url: str) -> tuple[int, bytes, HTTPMessage]:
+    def _parse_header_links(self, headers: HTTPMessage) -> dict:
         """
-        Makes a HTTP request to the given URL, and returns
-        the response status, body, and headers.
+        Parses link field from HTTP headers to a dictionary where
+        the link "rel" value is the key.
 
+        This is useful for example with GitLab REST API to get the pagination links.
 
         Parameters
         ----------
-        url : str
-            The URL of the HTTP request to make.
+        headers : HTTPMessage
+            The HTTP response headers that contain the links
 
         Returns
         -------
-        int
-            The HTTP response code, such as 200
-        bytes
-            The HTTP response body read as bytes
-        HTTPMessage
-            The HTTP response headers
+        dict
+            The header links in a dictionary, that can be used to for example pagination:
+            _parse_header_links(headers).get("next") returns the next page link, or None.
         """
-        logger.debug("Requesting %s", url)
-        req = request.Request(url, headers=self.get_headers())
-        with request.urlopen(req) as response:
-            return response.status, response.read(), response.headers
-
-    def _get_next_page(self, headers: HTTPMessage) -> int:
+        links = {}
+        header_links = headers.get("link")
+        if header_links:
+            items = header_links.split(",")
+            # Values are <uri-reference>; param1=value1; param2="value2"
+            for item in items:
+                parts = item.split(";", 1)
+                if parts:
+                    # First value should be the URI
+                    val = parts.pop(0).lstrip(" <").rstrip("> ")
+                    # The rest are the parameters; let's take the first one that has rel=
+                    # in it, split it with ; and take the first part as a value
+                    typ = parts.pop()
+                    typ = typ.split("rel=", 1).pop().split(";").pop(0).strip('" ')
+                    links[typ] = val
+        return links
+
+    def _build_path(self, *paths: str) -> str:
         """
-        Returns the next page from headers for pagination.
-
-        Uses the field x-next-page from the headers.
+        Returns the path to be appended to the REST API URL
 
         Parameters
         ----------
-        headers : HTTPMessage
-            The header from which to get the next page number for
-            pagination
+        paths : str
+            The path string that are joined with "/".
 
         Returns
         -------
-        int
-            The next page number. If headers were empty or they
-            did not include suitable item, returns 0. In such
-            case, do not attempt to fetch a next page.
-        """
-        ret = 0
-        if headers:
-            next_page = headers.get("x-next-page")
-            if next_page:
-                ret = int(next_page)
-                logger.debug("Response incomplete, next page is %s", next_page)
-            else:
-                logger.debug("Response complete")
-        return ret
+        str
+            A URL path, for example `projects/123/`
+            or `projects/namespace%2Fproject/`
+        """
+        quoted_paths = []
+        for subpath in paths:
+            quoted_paths.append(subpath)
+        return "/".join(quoted_paths)
 
-    def _build_query(self, arg: str, page: int) -> str:
+    def build_query(self, **args: str) -> str:
         """
         Builds a query for a GitLab REST API request
 
         Parameters
         ----------
-        arg : str
-            The args of the query that is endpoint specific
-        page : int
-            Page number for the pagination of the request.
-            Set to 0 to omit the pagination.
+        args : str
+            keyword arguments for the REST API query, like per_page=20, page=20
 
         Returns
         -------
         str
             A query string for a REST API request. Append this to
-            the request URL. Example `?arg=this&page=3`.
+            the request URL. Example `?per_page=20&page=20`.
         """
         query = ""
-        if arg or page:
-            if page:
-                page = "page=" + str(page)
-            query = f"?{'&'.join(filter(None, (arg, page)))}"
+        for key, value in args.items():
+            query = "&".join(filter(None, (query, f"{key}={parse.quote_plus(value)}")))
+        if query:
+            query = "?" + query
         return query
 
-    def gl_project_api(self, project: str, apath: str, arg: str = None) -> list:
+    def _get(self, url: str, headers: dict) -> tuple[int, bytes, HTTPMessage]:
         """
-        Returns data from the project REST API for the path. In case
+        Makes a raw GET request to the given URL, and returns
+        the response status, body, and headers.
+
+        Parameters
+        ----------
+        url : str
+            The URL of the HTTP request to make.
+        headers: dict
+            The HTTP headers used in the request.
+
+        Returns
+        -------
+        int
+            The HTTP response code, such as 200
+        bytes
+            The HTTP response body read as bytes
+        HTTPMessage
+            The HTTP response headers
+        """
+        logger.debug("Getting %s", url)
+        req = request.Request(url, headers=headers)
+        with request.urlopen(req) as response:
+            return response.status, response.read(), response.headers
+
+    def get(self, *paths: str, **query_params: str) -> tuple[int, bytes, HTTPMessage]:
+        """
+        Makes a HTTP GET request to the given GitLab path, and returns
+        the response status, body, and headers.
+
+        Parameters
+        ----------
+        paths : str
+            The URL path of the HTTP request to make.
+        query_params : str,  optional
+            Dictionary of query parameters for the request, like package_name=mypackage
+
+        Returns
+        -------
+        int
+            The HTTP response code, such as 200
+        bytes
+            The HTTP response body read as bytes
+        HTTPMessage
+            The HTTP response headers
+        """
+        url = self._url() + self._build_path(*paths) + self.build_query(**query_params)
+        headers = self._get_headers()
+        return self._get(url, headers)
+
+    def get_all(self, *paths: str, **query_params: str) -> list:
+        """
+        Returns data from the REST API endpoint. In case
         of multiple pages, all data will be returned.
 
         Parameters
         ----------
-        project : str
-            The project ID or the path of the project, including namespace.
-            Examples: `123` or `namespace/project`.
-        apath : str
-            The path of the project API endpoint that is called. For example packages
-        arg : str, optional
+        paths : str
+            The paths of the API endpoint that is called. For example projects, 123, packages
+            would be querying the projects/123/packages endpoint.
+        query_params : str, optional
             Additional arguments for the query of the URL, for example to filter
             results: package_name=mypackage
 
@@ -183,31 +212,80 @@ class Packages:
         list
             Data from GitLab REST API endpoint with the arguments.
         """
+        url = self._url() + self._build_path(*paths) + self.build_query(**query_params)
         data = []
-        more = True
-        page = None
-        while more:
-            more = False
-            query = self._build_query(arg, page)
-            url = self.project_api_url(project) + apath + query
-            status, res_data, headers = self._request(url)
-            logger.debug("Response status: %d", status)
+        while url:
+            res_status, res_data, res_headers = self._get(url, self._get_headers())
+            logger.debug("Response status: %d", res_status)
             res_data = loads(res_data)
             logger.debug("Response data: %s", res_data)
             data = data + res_data
-            page = self._get_next_page(headers)
-            if page:
-                more = True
+            url = self._parse_header_links(res_headers).get("next")
         return data
 
-    def list_packages(self, project: str, package_name: str) -> list:
+    def put(self, data: bytes, *paths: str, **query_params: str) -> int:
+        """
+        Makes a HTTP PUT request to the given GitLab path.
+
+        Parameters
+        ----------
+        data : bytes
+            The data to PUT.
+        paths : str
+            The URL path of the HTTP request to make.
+        query_params : str, optional
+            Additional arguments for the query of the URL, for example to filter
+            results: package_name=mypackage
+
+        Returns
+        -------
+        int
+            0 If the request was successful.
+        """
+        ret = 1
+        url = self._url() + self._build_path(*paths) + self.build_query(**query_params)
+        logger.debug("Putting %s", url)
+        req = request.Request(url, method="PUT", data=data, headers=self._get_headers())
+        with request.urlopen(req) as res:
+            if res.status == 201:  # 201 is created
+                ret = 0
+        return ret
+
+    def delete(self, *paths: str, **query_params: str) -> int:
+        """
+        Makes a HTTP DELETE request to the given GitLab path.
+
+        Parameters
+        ----------
+        paths : str
+            The URL path of the HTTP request to make.
+        query_params : str, optional
+            Additional arguments for the query of the URL, for example to filter
+            results: package_name=mypackage
+
+        Returns
+        -------
+        int
+            0 If the request was successful.
+        """
+        ret = 1
+        url = self._url() + self._build_path(*paths) + self.build_query(**query_params)
+        logger.debug("Deleting %s", url)
+        req = request.Request(url, method="DELETE", headers=self._get_headers())
+        with request.urlopen(req) as res:
+            if res.status == 204:
+                # 204 is no content, that GL responds when file deleted
+                ret = 0
+        return ret
+
+    def get_versions(self, project_id: str, package_name: str) -> list:
         """
         Lists the available versions of the package
 
         Parameters
         ----------
-        project : str
-            The project ID or the path of the project, including namespace.
+        project_id : str
+            The project ID or path, including namespace.
             Examples: `123` or `namespace/project`.
         package_name : str
             The name of the package that is listed.
@@ -219,8 +297,12 @@ class Packages:
         """
         packages = []
         logger.debug("Listing packages with name %s", package_name)
-        data = self.gl_project_api(
-            project, "packages", "package_name=" + parse.quote_plus(package_name)
+        data = self.get_all(
+            "projects",
+            parse.quote_plus(project_id),
+            "packages",
+            package_name=package_name,
+            package_type="generic",
         )
         for package in data:
             name = parse.unquote(package["name"])
@@ -232,46 +314,52 @@ class Packages:
             packages.append({"name": name, "version": version})
         return packages
 
-    def list_files(self, project: str, package_id: int) -> list:
+    def get_files(self, project_id: str, package_id: int) -> dict:
         """
         Lists all files of a specific package ID from GitLab REST API
 
         Parameters
         ----------
-        project : str
-            The project ID or the path of the project, including namespace.
+        project_id : str
+            The project ID or path, including namespace.
             Examples: `123` or `namespace/project`.
         package_id : int
             The package ID that is listed
 
         Return
         ------
-        list
-            List of file (names) that are in the package.
+        dict
+            Dictionary of file (names) that are in the package, with
+            each element containing a dictionary containing information
+            of the file
         """
-        files = []
+        files = {}
         logger.debug("Listing package %d files", package_id)
-        apath = "packages/" + parse.quote_plus(str(package_id)) + "/package_files"
-        data = self.gl_project_api(project, apath)
+        data = self.get_all(
+            "projects",
+            parse.quote_plus(project_id),
+            "packages",
+            str(package_id),
+            "package_files",
+        )
         for package in data:
             # Only append the filename once to the list of files
             # as there's no way to download them separately through
             # the API
             filename = parse.unquote(package["file_name"])
-            if filename not in files:
-                files.append(filename)
+            file_id = package["id"]
+            if not files.get(filename):
+                files[filename] = {"id": file_id}
         return files
 
-    def get_package_id(
-        self, project: str, package_name: str, package_version: str
-    ) -> int:
+    def get_id(self, project_id: str, package_name: str, package_version: str) -> int:
         """
         Gets the package ID of a specific package version.
 
         Parameters
         ----------
-        project : str
-            The project ID or the path of the project, including namespace.
+        project_id : str
+            The project ID or path, including namespace.
             Examples: `123` or `namespace/project`.
         package_name : str
             The name of the package.
@@ -281,18 +369,18 @@ class Packages:
         Return
         ------
         int
-            The ID of the package. Zero if no ID was found.
+            The ID of the package. -1 if no ID was found.
         """
-        package_id = 0
+        package_id = -1
         logger.debug("Fetching package %s (%s) ID", package_name, package_version)
-        apath = "packages"
-        arg = (
-            "package_name="
-            + parse.quote_plus(package_name)
-            + "&package_version="
-            + parse.quote_plus(package_version)
+        data = self.get_all(
+            "projects",
+            parse.quote_plus(project_id),
+            "packages",
+            package_name=package_name,
+            package_version=package_version,
+            package_type="generic",
         )
-        data = self.gl_project_api(project, apath, arg)
         if len(data) == 1:
             package = data.pop()
             package_id = package["id"]
@@ -300,7 +388,7 @@ class Packages:
 
     def download_file(
         self,
-        project: str,
+        project_id: str,
         package_name: str,
         package_version: str,
         filename: str,
@@ -311,8 +399,8 @@ class Packages:
 
         Parameters
         ----------
-        project : str
-            The project ID or the path of the project, including namespace.
+        project_id : str
+            The project ID or path, including namespace.
             Examples: `123` or `namespace/project`.
         package_name : str
             The name of the generic package.
@@ -331,16 +419,15 @@ class Packages:
         """
         ret = 1
         logger.debug("Downloading file %s", filename)
-        url = (
-            self.project_api_url(project)
-            + "packages/generic/"
-            + parse.quote_plus(package_name)
-            + "/"
-            + parse.quote_plus(package_version)
-            + "/"
-            + parse.quote(filename)
+        status, data, _ = self.get(
+            "projects",
+            parse.quote_plus(project_id),
+            "packages",
+            "generic",
+            parse.quote_plus(package_name),
+            parse.quote_plus(package_version),
+            parse.quote(filename),
         )
-        status, data, _ = self._request(url)
         if status == 200:
             fpath = os.path.join(destination, filename)
             parent = os.path.dirname(fpath)
@@ -356,10 +443,10 @@ class Packages:
 
     def upload_file(
         self,
-        project: str,
+        project_id: str,
         package_name: str,
         package_version: str,
-        pfile: str,
+        filename: str,
         source: str,
     ) -> int:
         """
@@ -367,14 +454,14 @@ class Packages:
 
         Parameters
         ----------
-        project : str
-            The project ID or the path of the project, including namespace.
+        project_id : str
+            The project ID or path, including namespace.
             Examples: `123` or `namespace/project`.
         package_name : str
             The name of the generic package.
         package_version : str
             The version of the generic package
-        file : str
+        pfile : str
             The relative path of the file that is uploaded. If left empty,
             all files from the source folder, and it's subfolders, are uploaded.
         source : str
@@ -388,8 +475,8 @@ class Packages:
         """
         files = []
         ret = 1
-        if pfile:
-            files.append(pfile)
+        if filename:
+            files.append(filename)
         else:
             filelist = glob(os.path.join(source, "**"), recursive=True)
             for item in filelist:
@@ -397,9 +484,9 @@ class Packages:
                 if os.path.isfile(os.path.join(item)):
                     # Remove the source folder from the path of the files
                     files.append(os.path.relpath(item, source))
-        for ufile in files:
+        for afile in files:
             ret = self._upload_file(
-                project, package_name, package_version, ufile, source
+                project_id, package_name, package_version, afile, source
             )
             if ret:
                 break
@@ -407,10 +494,10 @@ class Packages:
 
     def _upload_file(
         self,
-        project: str,
+        project_id: str,
         package_name: str,
         package_version: str,
-        pfile: str,
+        filename: str,
         source: str,
     ) -> int:
         """
@@ -418,14 +505,14 @@ class Packages:
 
         Parameters
         ----------
-        project : str
-            The project ID or the path of the project, including namespace.
+        project_id : str
+            The project ID or path, including namespace.
             Examples: `123` or `namespace/project`.
         package_name : str
             The name of the generic package.
         package_version : str
             The version of the generic package
-        file : str
+        filename : str
             The relative path of the file that is uploaded.
         source : str
             The source folder that is used as root when uploading.
@@ -436,22 +523,101 @@ class Packages:
             Zero if everything went fine, non-zero coke otherwise.
         """
         ret = 1
-        fpath = os.path.join(source, pfile)
-        logger.debug("Uploading file %s from %s", pfile, source)
+        fpath = os.path.join(source, filename)
+        logger.debug("Uploading file %s from %s", filename, source)
         with open(fpath, "rb") as data:
-            url = (
-                self.project_api_url(project)
-                + "packages/generic/"
-                + parse.quote_plus(package_name)
-                + "/"
-                + parse.quote_plus(package_version)
-                + "/"
-                + parse.quote(pfile)
+            ret = self.put(
+                data.read(),
+                "projects",
+                parse.quote_plus(project_id),
+                "packages",
+                "generic",
+                parse.quote_plus(package_name),
+                parse.quote_plus(package_version),
+                parse.quote(filename),
             )
-            req = request.Request(
-                url, method="PUT", data=data, headers=self.get_headers()
+        return ret
+
+    def delete_package(
+        self, project_id: str, package_name: str, package_version: str
+    ) -> int:
+        """
+        Deletes a version of a GitLab generic package.
+
+        Parameters
+        ----------
+        project_id : str
+            The project ID or path, including namespace.
+            Examples: `123` or `namespace/project`.
+        package_name : str
+            The name of the generic package.
+        package_version : str
+            The version of the generic package that is deleted
+
+        Return
+        ------
+        int
+            Zero if everything went fine, non-zero coke otherwise.
+        """
+        ret = 1
+        package_id = self.get_id(project_id, package_name, package_version)
+        if package_id > 0:
+            ret = self.delete(
+                "projects", parse.quote_plus(project_id), "packages", str(package_id)
             )
-            with request.urlopen(req) as res:
-                if res.status == 201:  # 201 is created
-                    ret = 0
+        return ret
+
+    def delete_file(
+        self,
+        project_id: str,
+        package_name: str,
+        package_version: str,
+        filename: str,
+    ) -> int:
+        """
+        Deletes a file from a GitLab generic package.
+
+        Parameters
+        ----------
+        project_id : str
+            The project ID or path, including namespace.
+            Examples: `123` or `namespace/project`.
+        package_name : str
+            The name of the generic package.
+        package_version : str
+            The version of the generic package
+        filename : str
+            The path of the file to be deleted in the package.
+
+        Return
+        ------
+        int
+            Zero if everything went fine, non-zero coke otherwise.
+        """
+        ret = 1
+        package_id = self.get_id(project_id, package_name, package_version)
+        if package_id > 0:
+            package_files = self.get_files(project_id, package_id)
+            file_id = package_files.get(filename)
+            if file_id and file_id.get("id"):
+                file_id = file_id.get("id")
+                ret = self._delete_file(project_id, package_id, file_id)
+        return ret
+
+    def _delete_file(self, project_id: str, package_id: int, file_id: int) -> int:
+        ret = 1
+        logger.info(
+            "Deleting file %d from package %d from project %s",
+            file_id,
+            package_id,
+            project_id,
+        )
+        ret = self.delete(
+            "projects",
+            parse.quote_plus(project_id),
+            "packages",
+            str(package_id),
+            "package_files",
+            str(file_id),
+        )
         return ret

{glpkg-1.3.0.dist-info → glpkg-1.4.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: glpkg
-Version: 1.3.0
+Version: 1.4.0
 Summary: Tool to make GitLab generic package registry operations easy.
 Author-email: bugproduction <bugproduction@outlook.com>
 License-Expression: MIT
@@ -15,6 +15,7 @@ Dynamic: license-file
 
 glpkg is a tool that makes it easy to work with [GitLab generic packages](https://docs.gitlab.com/user/packages/generic_packages/).
 
+Generic package registries of GitLab projects are supported. Group registries are not, as the GitLab REST API for groups is very limited.
 
 ## Installation
 
@@ -26,7 +27,6 @@ pip install glpkg
 
 To check the installation and version,  run:
 
-
 ```bash
 glpkg --version
 ```
@@ -117,6 +117,37 @@ glpkg upload --project 12345 --name mypackagename --version 1.0 --source upload
 
 Note: a file in `upload` folder will be uploaded to the root of the package. If you want to upload the file to a `dir` folder in the package, make a structure in the upload folder, like `upload/dir/`.
 
+### Delete a file from a generic package
+
+To delete a file from a specific generic package, run
+
+```bash
+glpkg delete --project 12345 --name mypackagename --version 1.0 --file my-file.txt
+```
+
+Where
+- `12345` is your projects ID ([Find the Project ID](https://docs.gitlab.com/user/project/working_with_projects/#find-the-project-id)) or the path of the project (like `namespace/project`)
+- `mypackagename` is the name of the generic package
+- `1.0` is the version of the generic package from the file is deleted
+- `my-file.txt` is the file that is deleted. Only relative paths are supported. Note that the package may contain multiple files with same name. In this case, one file of them is deleted.
+
+The token that is used to delete files must have at least Maintainer role in the project.
+
+### Delete a package version
+
+To delete a specific generic package version, run
+
+```bash
+glpkg delete --project 12345 --name mypackagename --version 1.0
+```
+
+Where
+- `12345` is your projects ID ([Find the Project ID](https://docs.gitlab.com/user/project/working_with_projects/#find-the-project-id)) or the path of the project (like `namespace/project`)
+- `mypackagename` is the name of the generic package
+- `1.0` is the version of the generic package that is deleted
+
+The token that is used to delete packages must have at least Maintainer role in the project.
+
 ### Use in GitLab pipelines
 
 If you use the tool in a GitLab pipeline, setting argument `--ci` uses [GitLab predefined variables](https://docs.gitlab.com/ci/variables/predefined_variables/) to configure the tool. In this case `CI_SERVER_HOST`, `CI_PROJECT_ID`, and `CI_JOB_TOKEN` environment variables are used. The `--project`, and `--token` arguments can still be used to override the project ID or to use a personal or project access token instead of `CI_JOB_TOKEN`.
@@ -128,10 +159,3 @@ glpkg upload --ci --name mypackagename --version 1.0 --file my-file.txt
 ```
 
 To use the `CI_JOB_TOKEN` with package registry of another projects, add `--project <otherproject ID>` argument. Remember that you may need to add [permissions for the CI_JOB_TOKEN](https://docs.gitlab.com/ci/jobs/ci_job_token/#control-job-token-access-to-your-project) in the other project.
-
-
-## Limitations
-
-The tool is not perfect (yet) and has limitations. The following limitations are known, but more can exist:
-
-- Only project registries are supported for now.

glpkg-1.4.0.dist-info/RECORD

@@ -0,0 +1,10 @@
+gitlab/__init__.py,sha256=TXqR34k7YgbFTeeKfSOdxBH0lFaC3-SiZU5mTBL9GI0,105
+gitlab/__main__.py,sha256=UPVixjP98KzJi9Ljth4yqqDTTaE3EfyAuj2xGCQAGys,586
+gitlab/cli_handler.py,sha256=02Yc3yE3jNMGTx_HvUu0rYH5NwxrnTRaaeAGMFh8Mq8,14273
+gitlab/packages.py,sha256=wP0hRLad09LoE9uinUljrvGoBt6KfP49QESqOpxLihQ,20255
+glpkg-1.4.0.dist-info/licenses/LICENSE.md,sha256=josGXvZq628dNS0Iru58-DPE7dRpDXzjJxKKT35103g,1065
+glpkg-1.4.0.dist-info/METADATA,sha256=PX4jWVi_HCznrjQ9OztSYqYurdqv1-qHXKbkRiIUVlU,7678
+glpkg-1.4.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+glpkg-1.4.0.dist-info/entry_points.txt,sha256=xHPZwx2oShYDZ3AyH7WSIvuhFMssy7QLlQk-JAbje_w,46
+glpkg-1.4.0.dist-info/top_level.txt,sha256=MvIaP8p_Oaf4gO_hXmHkX-5y2deHLp1pe6tJR3ukQ6o,7
+glpkg-1.4.0.dist-info/RECORD,,

glpkg-1.3.0.dist-info/RECORD

@@ -1,10 +0,0 @@
-gitlab/__init__.py,sha256=ZXRwtUQEDE9bdewmwKYCjMAhm5KsuvAe525_QBiWLHY,105
-gitlab/__main__.py,sha256=UPVixjP98KzJi9Ljth4yqqDTTaE3EfyAuj2xGCQAGys,586
-gitlab/cli_handler.py,sha256=2P3R-yYkT6D5CjNCAEd9FC9HYI09aJ_eyMSMsOHtZzs,12289
-gitlab/packages.py,sha256=50CbLdYxj0r6l8J40TxpIo2hTkKlv1BCFywFR6lg2nc,14785
-glpkg-1.3.0.dist-info/licenses/LICENSE.md,sha256=josGXvZq628dNS0Iru58-DPE7dRpDXzjJxKKT35103g,1065
-glpkg-1.3.0.dist-info/METADATA,sha256=4bQDKmHrf2da0eQ2hjfQKKItoirfcIr1VbWa3hwxbwY,6362
-glpkg-1.3.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-glpkg-1.3.0.dist-info/entry_points.txt,sha256=xHPZwx2oShYDZ3AyH7WSIvuhFMssy7QLlQk-JAbje_w,46
-glpkg-1.3.0.dist-info/top_level.txt,sha256=MvIaP8p_Oaf4gO_hXmHkX-5y2deHLp1pe6tJR3ukQ6o,7
-glpkg-1.3.0.dist-info/RECORD,,