cloudos-cli 2.47.1__tar.gz → 2.49.0__tar.gz

{cloudos_cli-2.47.1 → cloudos_cli-2.49.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cloudos_cli
-Version: 2.47.1
+Version: 2.49.0
 Summary: Python package for interacting with CloudOS
 Home-page: https://github.com/lifebit-ai/cloudos-cli
 Author: David Piñeyro
@@ -180,7 +180,7 @@ cloudos --help
 │ configure              CloudOS configuration.                                                                                                                   │
 │ cromwell               Cromwell server functionality: check status, start and stop.                                                                             │
 │ job                    CloudOS job functionality: run, check and abort jobs in CloudOS.                                                                         │
-│ project                CloudOS project functionality: list projects in CloudOS.                                                                                 │
+│ project                CloudOS project functionality: list and create projects in CloudOS.                                                                       │
 │ queue                  CloudOS job queue functionality.                                                                                                         │
 │ workflow               CloudOS workflow functionality: list and import workflows.                                                                               │
 ╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
@@ -775,16 +775,15 @@ This file can later be used when running a job with `cloudos job run --job-confi
 > [!NOTE]
 > Job details can only be retrieved for a single user, cannot see other user's job details.
 
-#### Get a list of your jobs from a CloudOS workspace
+#### Get a list of workspace jobs from a CloudOS
 
-You can get a summary of your last 30 submitted jobs (or your selected number of last jobs using `--last-n-jobs n`
-parameter) in two different formats:
+You can get a summary of the workspace's last 30 submitted jobs (or a selected number of last jobs using `--last-n-jobs n` parameter) in two different formats:
 
 - CSV: this is a table with a minimum predefined set of columns by default, or all the
 available columns using the `--all-fields` argument.
-- JSON: all the available information from your jobs, in JSON format.
+- JSON: all the available information from the workspace jobs, in JSON format (`--all-fields` is always enabled for this format).
 
-To get a list with your last 30 submitted jobs to a given workspace, in CSV format, use
+To get a list with the workspace's last 30 submitted jobs, in CSV format, use
 the following command:
 
 ```bash
@@ -806,7 +805,7 @@ Executing list...
 
 In addition, a file named `joblist.csv` is created.
 
-To get the same information, but for all your jobs and in JSON format, use the following command:
+To get the same information, but for all the workspace's jobs and in JSON format, use the following command:
 
 ```bash
 cloudos job list \
@@ -947,6 +946,25 @@ Executing list...
 	Workflow list saved to project_list.csv
 ```
 
+#### Create a new project in CloudOS
+
+You can create a new project in your CloudOS workspace using the `project create` command.
+This command requires the name of the new project and will return the project ID upon successful creation.
+
+```bash
+cloudos project create \
+    --cloudos-url $CLOUDOS \
+    --apikey $MY_API_KEY \
+    --workspace-id $WORKSPACE_ID \
+    --new-project "My New Project"
+```
+
+The expected output is something similar to:
+
+```console
+	Project "My New Project" created successfully with ID: 64f1a23b8e4c9d001234abcd
+```
+
 #### Get a list of the available job queues
 
 Job queues are required for running jobs using AWS batch executor. The available job queues in your CloudOS workspace are

{cloudos_cli-2.47.1 → cloudos_cli-2.49.0}/README.md

@@ -145,7 +145,7 @@ cloudos --help
 │ configure              CloudOS configuration.                                                                                                                   │
 │ cromwell               Cromwell server functionality: check status, start and stop.                                                                             │
 │ job                    CloudOS job functionality: run, check and abort jobs in CloudOS.                                                                         │
-│ project                CloudOS project functionality: list projects in CloudOS.                                                                                 │
+│ project                CloudOS project functionality: list and create projects in CloudOS.                                                                       │
 │ queue                  CloudOS job queue functionality.                                                                                                         │
 │ workflow               CloudOS workflow functionality: list and import workflows.                                                                               │
 ╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
@@ -740,16 +740,15 @@ This file can later be used when running a job with `cloudos job run --job-confi
 > [!NOTE]
 > Job details can only be retrieved for a single user, cannot see other user's job details.
 
-#### Get a list of your jobs from a CloudOS workspace
+#### Get a list of workspace jobs from a CloudOS
 
-You can get a summary of your last 30 submitted jobs (or your selected number of last jobs using `--last-n-jobs n`
-parameter) in two different formats:
+You can get a summary of the workspace's last 30 submitted jobs (or a selected number of last jobs using `--last-n-jobs n` parameter) in two different formats:
 
 - CSV: this is a table with a minimum predefined set of columns by default, or all the
 available columns using the `--all-fields` argument.
-- JSON: all the available information from your jobs, in JSON format.
+- JSON: all the available information from the workspace jobs, in JSON format (`--all-fields` is always enabled for this format).
 
-To get a list with your last 30 submitted jobs to a given workspace, in CSV format, use
+To get a list with the workspace's last 30 submitted jobs, in CSV format, use
 the following command:
 
 ```bash
@@ -771,7 +770,7 @@ Executing list...
 
 In addition, a file named `joblist.csv` is created.
 
-To get the same information, but for all your jobs and in JSON format, use the following command:
+To get the same information, but for all the workspace's jobs and in JSON format, use the following command:
 
 ```bash
 cloudos job list \
@@ -912,6 +911,25 @@ Executing list...
 	Workflow list saved to project_list.csv
 ```
 
+#### Create a new project in CloudOS
+
+You can create a new project in your CloudOS workspace using the `project create` command.
+This command requires the name of the new project and will return the project ID upon successful creation.
+
+```bash
+cloudos project create \
+    --cloudos-url $CLOUDOS \
+    --apikey $MY_API_KEY \
+    --workspace-id $WORKSPACE_ID \
+    --new-project "My New Project"
+```
+
+The expected output is something similar to:
+
+```console
+	Project "My New Project" created successfully with ID: 64f1a23b8e4c9d001234abcd
+```
+
 #### Get a list of the available job queues
 
 Job queues are required for running jobs using AWS batch executor. The available job queues in your CloudOS workspace are

{cloudos_cli-2.47.1 → cloudos_cli-2.49.0}/cloudos_cli/__main__.py

@@ -79,7 +79,8 @@ def run_cloudos_cli(ctx):
                 'import': shared_config
             },
             'project': {
-                'list': shared_config
+                'list': shared_config,
+                'create': shared_config
             },
             'cromwell': {
                 'status': shared_config,
@@ -139,7 +140,8 @@ def run_cloudos_cli(ctx):
                 'import': shared_config
             },
             'project': {
-                'list': shared_config
+                'list': shared_config,
+                'create': shared_config
             },
             'cromwell': {
                 'status': shared_config,
@@ -186,7 +188,7 @@ def workflow():
 
 @run_cloudos_cli.group()
 def project():
-    """CloudOS project functionality: list projects in CloudOS."""
+    """CloudOS project functionality: list and create projects in CloudOS."""
     print(project.__doc__ + '\n')
 
 
@@ -1174,17 +1176,17 @@ def job_details(ctx,
               default='joblist',
               required=False)
 @click.option('--output-format',
-              help='The desired file format (file extension) for the output. Default=csv.',
+              help='The desired file format (file extension) for the output. For json option --all-fields will be automatically set to True. Default=csv.',
               type=click.Choice(['csv', 'json'], case_sensitive=False),
               default='csv')
 @click.option('--all-fields',
               help=('Whether to collect all available fields from jobs or ' +
                     'just the preconfigured selected fields. Only applicable ' +
-                    'when --output-format=csv'),
+                    'when --output-format=csv. Automatically enabled for json output.'),
               is_flag=True)
 @click.option('--last-n-jobs',
-              help=("The number of last user's jobs to retrieve. You can use 'all' to " +
-                    "retrieve all user's jobs. Default=30."),
+              help=("The number of last workspace jobs to retrieve. You can use 'all' to " +
+                    "retrieve all workspace jobs. Default=30."),
               default='30')
 @click.option('--page',
               help=('Response page to retrieve. If --last-n-jobs is set, then --page ' +
@@ -1219,7 +1221,7 @@ def list_jobs(ctx,
               disable_ssl_verification,
               ssl_cert,
               profile):
-    """Collect all your jobs from a CloudOS workspace in CSV format."""
+    """Collect workspace jobs from a CloudOS workspace in CSV or JSON format."""
     profile = profile or ctx.default_map['job']['list']['profile']
     # Create a dictionary with required and non-required params
     required_dict = {
@@ -1268,6 +1270,7 @@ def list_jobs(ctx,
         except ValueError:
             print("[ERROR] last-n-jobs value was not valid. Please use a positive int or 'all'")
             raise
+
     my_jobs_r = cl.get_job_list(workspace_id, last_n_jobs, page, archived, verify_ssl)
     if len(my_jobs_r) == 0:
         if ctx.get_parameter_source('page') == click.core.ParameterSource.DEFAULT:
@@ -1279,15 +1282,14 @@ def list_jobs(ctx,
                   'using --page parameter.')
     elif output_format == 'csv':
         my_jobs = cl.process_job_list(my_jobs_r, all_fields)
-        my_jobs.to_csv(outfile, index=False)
-        print(f'\tJob list collected with a total of {my_jobs.shape[0]} jobs.')
+        cl.save_job_list_to_csv(my_jobs, outfile)
     elif output_format == 'json':
         with open(outfile, 'w') as o:
             o.write(json.dumps(my_jobs_r))
         print(f'\tJob list collected with a total of {len(my_jobs_r)} jobs.')
+        print(f'\tJob list saved to {outfile}')
     else:
         raise ValueError('Unrecognised output format. Please use one of [csv|json]')
-    print(f'\tJob list saved to {outfile}')
 
 
 @job.command('abort')
@@ -1701,6 +1703,93 @@ def list_projects(ctx,
     print(f'\tProject list saved to {outfile}')
 
 
+@project.command('create')
+@click.option('-k',
+              '--apikey',
+              help='Your CloudOS API key',
+              required=True)
+@click.option('-c',
+              '--cloudos-url',
+              help=(f'The CloudOS url you are trying to access to. Default={CLOUDOS_URL}.'),
+              default=CLOUDOS_URL,
+              required=True)
+@click.option('--workspace-id',
+              help='The specific CloudOS workspace id.',
+              required=True)
+@click.option('--new-project',
+              help='The name for the new project.',
+              required=True)
+@click.option('--verbose',
+              help='Whether to print information messages or not.',
+              is_flag=True)
+@click.option('--disable-ssl-verification',
+              help=('Disable SSL certificate verification. Please, remember that this option is ' +
+                    'not generally recommended for security reasons.'),
+              is_flag=True)
+@click.option('--ssl-cert',
+              help='Path to your SSL certificate file.')
+@click.option('--profile', help='Profile to use from the config file', default=None)
+@click.pass_context
+def create_project(ctx,
+                   apikey,
+                   cloudos_url,
+                   workspace_id,
+                   new_project,
+                   verbose,
+                   disable_ssl_verification,
+                   ssl_cert,
+                   profile):
+    """Create a new project in CloudOS."""
+    profile = profile or ctx.default_map['project']['create']['profile']
+    # Create a dictionary with required and non-required params
+    required_dict = {
+        'apikey': True,
+        'workspace_id': True,
+        'workflow_name': False,
+        'project_name': False,
+        'procurement_id': False
+    }
+    # determine if the user provided all required parameters
+    config_manager = ConfigurationProfile()
+    user_options = (
+        config_manager.load_profile_and_validate_data(
+            ctx,
+            INIT_PROFILE,
+            CLOUDOS_URL,
+            profile=profile,
+            required_dict=required_dict,
+            apikey=apikey,
+            cloudos_url=cloudos_url,
+            workspace_id=workspace_id,
+            project_name=new_project
+        )
+    )
+    # replace the profile parameters with arguments given by the user
+    apikey = user_options['apikey']
+    cloudos_url = user_options['cloudos_url']
+    workspace_id = user_options['workspace_id']
+
+    # verify ssl configuration
+    verify_ssl = ssl_selector(disable_ssl_verification, ssl_cert)
+
+    # Print basic output
+    if verbose:
+        print(f'\tUsing CloudOS URL: {cloudos_url}')
+        print(f'\tUsing workspace: {workspace_id}')
+        print(f'\tProject name: {new_project}')
+
+    cl = Cloudos(cloudos_url=cloudos_url, apikey=apikey, cromwell_token=None)
+
+    try:
+        project_id = cl.create_project(workspace_id, new_project, verify_ssl)
+        print(f'\tProject "{new_project}" created successfully with ID: {project_id}')
+        if verbose:
+            print(f'\tProject URL: {cloudos_url}/app/projects/{project_id}')
+    except Exception as e:
+        print(f'\tError creating project: {str(e)}')
+        sys.exit(1)
+
+
 @cromwell.command('status')
 @click.version_option()
 @click.option('-k',

cloudos_cli-2.49.0/cloudos_cli/_version.py

@@ -0,0 +1 @@
+__version__ = '2.49.0'

{cloudos_cli-2.47.1 → cloudos_cli-2.49.0}/cloudos_cli/clos.py

@@ -11,6 +11,8 @@ from cloudos_cli.utils.errors import BadRequestException, JoBNotCompletedExcepti
 from cloudos_cli.utils.requests import retry_requests_get, retry_requests_post, retry_requests_put
 import pandas as pd
 from cloudos_cli.utils.last_wf import youngest_workflow_id_by_name
+from datetime import datetime
+
 
 # GLOBAL VARS
 JOB_COMPLETED = 'completed'
@@ -430,28 +432,27 @@ class Cloudos:
         df : pandas.DataFrame
             A DataFrame with the requested columns from the jobs.
         """
-        COLUMNS = ['_id',
-                   'team',
+        COLUMNS = ['status',
                    'name',
-                   'parameters',
-                   'status',
+                   'project.name',
+                   'user.name',
+                   'user.surname',
+                   'workflow.name',
+                   '_id',
                    'startTime',
                    'endTime',
                    'createdAt',
                    'updatedAt',
-                   'computeCostSpent',
-                   'masterInstanceStorageCost',
-                   'user.id',
-                   'workflow._id',
-                   'workflow.name',
-                   'workflow.description',
-                   'workflow.createdAt',
-                   'workflow.updatedAt',
-                   'workflow.workflowType',
-                   'project._id',
-                   'project.name',
-                   'project.createdAt',
-                   'project.updatedAt'
+                   'revision.commit',
+                   'realInstancesExecutionCost',
+                   'masterInstance.usedInstance.type',
+                   'storageMode',
+                   'workflow.repository.url',
+                   'nextflowVersion',
+                   'batch.enabled',
+                   'storageSizeInGb',
+                   'batch.jobQueue.id',
+                   'usesFusionFileSystem'
                    ]
         df_full = pd.json_normalize(r)
         if df_full.empty:
@@ -462,6 +463,156 @@ class Cloudos:
             df = df_full.loc[:, COLUMNS]
         return df
 
+    def reorder_job_list(self, my_jobs_df, filename='my_jobs.csv'):
+        """Save a job list DataFrame to a CSV file with renamed and ordered columns.
+
+        Parameters
+        ----------
+        my_jobs_df : pandas.DataFrame
+            A DataFrame containing job information from process_job_list.
+        filename : str
+            The name of the file to save the DataFrame to. Default is 'my_jobs.csv'.
+
+        Returns
+        -------
+        None
+            Saves the DataFrame to a CSV file with renamed and ordered columns.
+        """
+        # Handle empty DataFrame
+        if my_jobs_df.empty:
+            print("Warning: DataFrame is empty. Creating empty CSV file.")
+            empty_df = pd.DataFrame()
+            empty_df.to_csv(filename, index=False)
+            return
+
+        # Create a copy to avoid modifying the original DataFrame
+        jobs_df = my_jobs_df.copy()
+
+        # 1. Fusion user.name and user.surname into user
+        if 'user.name' in jobs_df.columns and 'user.surname' in jobs_df.columns:
+            jobs_df['user'] = jobs_df.apply(
+                lambda row: f"{row.get('user.name', '')} {row.get('user.surname', '')}".strip()
+                if pd.notna(row.get('user.name')) or pd.notna(row.get('user.surname'))
+                else None, axis=1
+            )
+            # Remove original columns
+            jobs_df = jobs_df.drop(columns=['user.name', 'user.surname'], errors='ignore')
+
+        # 2. Convert time fields to human-readable format
+        time_columns = ['startTime', 'endTime', 'createdAt', 'updatedAt']
+        for col in time_columns:
+            if col in jobs_df.columns:
+                def format_time(x):
+                    if pd.notna(x) and isinstance(x, str) and x:
+                        try:
+                            return datetime.fromisoformat(x.replace('Z', '+00:00')).strftime('%Y-%m-%d %H:%M:%S UTC')
+                        except (ValueError, TypeError):
+                            return x  # Return original value if parsing fails
+                    return None
+                jobs_df[col] = jobs_df[col].apply(format_time)
+
+        # 3. Format realInstancesExecutionCost (divide by 100, show 4 decimals)
+        if 'realInstancesExecutionCost' in jobs_df.columns:
+            def format_cost(x):
+                if pd.notna(x) and x != '' and x is not None:
+                    try:
+                        return f"{float(x) / 100:.4f}"
+                    except (ValueError, TypeError):
+                        return x  # Return original value if conversion fails
+                return None
+            jobs_df['realInstancesExecutionCost'] = jobs_df['realInstancesExecutionCost'].apply(format_cost)
+
+        # 4. Calculate Run time (endTime - startTime)
+        if 'startTime' in jobs_df.columns and 'endTime' in jobs_df.columns:
+            def calculate_runtime(row):
+                start_time = row.get('startTime')
+                end_time = row.get('endTime')
+                if pd.notna(start_time) and pd.notna(end_time) and start_time and end_time:
+                    # Use original times from the original DataFrame for calculation
+                    original_start = my_jobs_df.iloc[row.name].get('startTime') if row.name < len(my_jobs_df) else start_time
+                    original_end = my_jobs_df.iloc[row.name].get('endTime') if row.name < len(my_jobs_df) else end_time
+                    if pd.notna(original_start) and pd.notna(original_end) and original_start and original_end:
+                        try:
+                            start_dt = datetime.fromisoformat(str(original_start).replace('Z', '+00:00'))
+                            end_dt = datetime.fromisoformat(str(original_end).replace('Z', '+00:00'))
+                            duration = end_dt - start_dt
+                            # Format duration as hours:minutes:seconds
+                            total_seconds = int(duration.total_seconds())
+                            hours = total_seconds // 3600
+                            minutes = (total_seconds % 3600) // 60
+                            seconds = total_seconds % 60
+                            if hours > 0:
+                                return f"{hours}h {minutes}m {seconds}s"
+                            elif minutes > 0:
+                                return f"{minutes}m {seconds}s"
+                            else:
+                                return f"{seconds}s"
+                        except (ValueError, TypeError):
+                            return None
+                return None
+
+            jobs_df['Run time'] = jobs_df.apply(calculate_runtime, axis=1)
+
+        # 5. Format batch.enabled (True -> "Batch", else "N/A")
+        if 'batch.enabled' in jobs_df.columns:
+            jobs_df['batch.enabled'] = jobs_df['batch.enabled'].apply(
+                lambda x: "Batch" if x is True else "N/A"
+            )
+
+        # 6. Rename columns using the provided dictionary
+        column_name_mapping = {
+            "status": "Status",
+            "name": "Name",
+            "project.name": "Project",
+            "user": "Owner",
+            "workflow.name": "Pipeline",
+            "_id": "ID",
+            "createdAt": "Submit time",
+            "updatedAt": "End time",
+            "revision.commit": "Commit",
+            "realInstancesExecutionCost": "Cost",
+            "masterInstance.usedInstance.type": "Resources",
+            "storageMode": "Storage type",
+            "workflow.repository.url": "Pipeline url",
+            "nextflowVersion": "Nextflow version",
+            "batch.enabled": "Executor",
+            "storageSizeInGb": "Storage size",
+            "batch.jobQueue.id": "Job queue ID",
+            "usesFusionFileSystem": "Accelerated file staging"
+        }
+
+        # Rename columns that exist in the DataFrame
+        jobs_df = jobs_df.rename(columns=column_name_mapping)
+
+        # Remove the original startTime and endTime columns since we now have Submit time, End time, and Run time
+        jobs_df = jobs_df.drop(columns=['startTime', 'endTime'], errors='ignore')
+
+        # 7. Define the desired order of columns
+        desired_order = [
+            "Status", "Name", "Project", "Owner", "Pipeline", "ID",
+            "Submit time", "End time", "Run time", "Commit", "Cost",
+            "Resources", "Storage type", "Pipeline url",
+            "Nextflow version", "Executor", "Storage size", "Job queue ID",
+            "Accelerated file staging"
+        ]
+
+        # Reorder columns - only include columns that exist in the DataFrame
+        available_columns = [col for col in desired_order if col in jobs_df.columns]
+        # Add any remaining columns that aren't in the desired order
+        remaining_columns = [col for col in jobs_df.columns if col not in desired_order]
+        final_column_order = available_columns + remaining_columns
+
+        # Reorder the DataFrame
+        jobs_df = jobs_df[final_column_order]
+        return jobs_df
+
+    def save_job_list_to_csv(self, my_jobs_df, filename='my_jobs.csv'):
+        # Save to CSV
+        jobs_df = self.reorder_job_list(my_jobs_df, filename)
+        jobs_df.to_csv(filename, index=False)
+        print(f'\tJob list collected with a total of {len(jobs_df)} jobs.')
+        print(f'\tJob list saved to {filename}')
+
     def get_workflow_list(self, workspace_id, verify=True, get_all=True,
                           page=1, page_size=10, max_page_size=100,
                           archived_status=False):
@@ -916,6 +1067,52 @@ class Cloudos:
 
         return project_id
 
+    def create_project(self, workspace_id, project_name, verify=True):
+        """Create a new project in CloudOS.
+
+        Parameters
+        ----------
+        workspace_id : str
+            The CloudOS workspace ID where the project will be created.
+        project_name : str
+            The name for the new project.
+        verify : [bool | str], optional
+            Whether to use SSL verification or not. Alternatively, if
+            a string is passed, it will be interpreted as the path to
+            the SSL certificate file. Default is True.
+
+        Returns
+        -------
+        str
+            The ID of the newly created project.
+
+        Raises
+        ------
+        BadRequestException
+            If the request to create the project fails with a status code
+            indicating an error.
+        """
+        data = {
+            "name": project_name
+        }
+        headers = {
+            "Content-type": "application/json",
+            "apikey": self.apikey
+        }
+        r = retry_requests_post("{}/api/v1/projects?teamId={}".format(self.cloudos_url,
+                                                                      workspace_id),
+                                json=data, headers=headers, verify=verify)
+        if r.status_code == 401:
+            raise ValueError('It seems your API key is not authorised. Please check if ' +
+                             'you have used the correct API key for the selected workspace')
+        elif r.status_code == 409:
+            raise ValueError(f'It seems that there is another project named "{project_name}" ' +
+                             'in your workspace, please use another name for the new project')
+        elif r.status_code >= 400:
+            raise BadRequestException(r)
+        content = json.loads(r.content)
+        return content['_id']
+
     def get_workflow_max_pagination(self, workspace_id, workflow_name, verify=True):
         """Retrieve the workflows max pages from API.
 

{cloudos_cli-2.47.1 → cloudos_cli-2.49.0}/cloudos_cli.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cloudos_cli
-Version: 2.47.1
+Version: 2.49.0
 Summary: Python package for interacting with CloudOS
 Home-page: https://github.com/lifebit-ai/cloudos-cli
 Author: David Piñeyro
@@ -180,7 +180,7 @@ cloudos --help
 │ configure              CloudOS configuration.                                                                                                                   │
 │ cromwell               Cromwell server functionality: check status, start and stop.                                                                             │
 │ job                    CloudOS job functionality: run, check and abort jobs in CloudOS.                                                                         │
-│ project                CloudOS project functionality: list projects in CloudOS.                                                                                 │
+│ project                CloudOS project functionality: list and create projects in CloudOS.                                                                       │
 │ queue                  CloudOS job queue functionality.                                                                                                         │
 │ workflow               CloudOS workflow functionality: list and import workflows.                                                                               │
 ╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
@@ -775,16 +775,15 @@ This file can later be used when running a job with `cloudos job run --job-confi
 > [!NOTE]
 > Job details can only be retrieved for a single user, cannot see other user's job details.
 
-#### Get a list of your jobs from a CloudOS workspace
+#### Get a list of workspace jobs from a CloudOS
 
-You can get a summary of your last 30 submitted jobs (or your selected number of last jobs using `--last-n-jobs n`
-parameter) in two different formats:
+You can get a summary of the workspace's last 30 submitted jobs (or a selected number of last jobs using `--last-n-jobs n` parameter) in two different formats:
 
 - CSV: this is a table with a minimum predefined set of columns by default, or all the
 available columns using the `--all-fields` argument.
-- JSON: all the available information from your jobs, in JSON format.
+- JSON: all the available information from the workspace jobs, in JSON format (`--all-fields` is always enabled for this format).
 
-To get a list with your last 30 submitted jobs to a given workspace, in CSV format, use
+To get a list with the workspace's last 30 submitted jobs, in CSV format, use
 the following command:
 
 ```bash
@@ -806,7 +805,7 @@ Executing list...
 
 In addition, a file named `joblist.csv` is created.
 
-To get the same information, but for all your jobs and in JSON format, use the following command:
+To get the same information, but for all the workspace's jobs and in JSON format, use the following command:
 
 ```bash
 cloudos job list \
@@ -947,6 +946,25 @@ Executing list...
 	Workflow list saved to project_list.csv
 ```
 
+#### Create a new project in CloudOS
+
+You can create a new project in your CloudOS workspace using the `project create` command.
+This command requires the name of the new project and will return the project ID upon successful creation.
+
+```bash
+cloudos project create \
+    --cloudos-url $CLOUDOS \
+    --apikey $MY_API_KEY \
+    --workspace-id $WORKSPACE_ID \
+    --new-project "My New Project"
+```
+
+The expected output is something similar to:
+
+```console
+	Project "My New Project" created successfully with ID: 64f1a23b8e4c9d001234abcd
+```
+
 #### Get a list of the available job queues
 
 Job queues are required for running jobs using AWS batch executor. The available job queues in your CloudOS workspace are

{cloudos_cli-2.47.1 → cloudos_cli-2.49.0}/cloudos_cli.egg-info/SOURCES.txt

@@ -34,4 +34,5 @@ cloudos_cli/utils/last_wf.py
 cloudos_cli/utils/requests.py
 cloudos_cli/utils/resources.py
 tests/__init__.py
-tests/functions_for_pytest.py
+tests/functions_for_pytest.py
+tests/test_cli_project_create.py

cloudos_cli-2.49.0/tests/test_cli_project_create.py

@@ -0,0 +1,53 @@
+import pytest
+from click.testing import CliRunner
+from cloudos_cli.__main__ import run_cloudos_cli
+
+
+def test_project_create_command_exists():
+    """
+    Test that the 'project create' command exists and shows proper help
+    """
+    runner = CliRunner()
+    
+    # Test that project create command exists
+    result = runner.invoke(run_cloudos_cli, ['project', 'create', '--help'])
+    
+    # Command should exist and not error out
+    assert result.exit_code == 0
+    
+    # Check that the help text contains expected options
+    assert 'Create a new project in CloudOS' in result.output
+    assert '--new-project' in result.output
+    assert '--workspace-id' in result.output
+    assert '--apikey' in result.output
+    assert '--cloudos-url' in result.output
+
+
+def test_project_create_command_structure():
+    """
+    Test that the 'project create' command has the correct structure and options
+    """
+    runner = CliRunner()
+    
+    # Test that the command exists and can show help without making API calls
+    result = runner.invoke(run_cloudos_cli, ['project', 'create', '--help'])
+    
+    # Command should exist and show help properly
+    assert result.exit_code == 0
+    assert 'Create a new project in CloudOS' in result.output
+    assert '--new-project' in result.output
+    assert 'required' in result.output  # Required arguments should be marked as such
+
+
+def test_project_group_contains_create_command():
+    """
+    Test that the 'project' group contains the 'create' command
+    """
+    runner = CliRunner()
+    
+    # Test that project group shows create command
+    result = runner.invoke(run_cloudos_cli, ['project', '--help'])
+    
+    assert result.exit_code == 0
+    assert 'create' in result.output
+    assert 'Create a new project in CloudOS' in result.output

cloudos_cli-2.47.1/cloudos_cli/_version.py

@@ -1 +0,0 @@
-__version__ = '2.47.1'