Skip to content

Commit 43277ac

Browse files
authored
Merge pull request #300 from ExaWorks/update_repo_refs
Updated name/references to `psij-python` from `psi-j-python`.
2 parents 079ec6a + 8c289af commit 43277ac

File tree

12 files changed

+68
-61
lines changed

12 files changed

+68
-61
lines changed

QuickStart.md

Lines changed: 9 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -3,27 +3,27 @@
33
This document will guide you through the install procedure and your first hello world example.
44

55
- [Requirements](#requirements)
6-
- [Install psi-j](#install-psi-j)
6+
- [Install psij](#install-psij)
77
- [Hello World example](#hello-world)
88

99
## Requirements
1010
- python3.7+
1111

12-
## Install psi-j
12+
## Install psij
1313

14-
If you have conda installed you might want to start from a fresh environment. This part is not installing psi-j but setting up a new environment with the specified python version:
14+
If you have conda installed you might want to start from a fresh environment. This part is not installing psij but setting up a new environment with the specified python version:
1515

16-
1. `conda create -n psi-j python=3.7`
17-
2. `conda activate psi-j`
16+
1. `conda create -n psij python=3.7`
17+
2. `conda activate psij`
1818

1919

20-
Install psi-j from the github repository:
20+
Install psij from the github repository:
2121

2222
1. Clone repository into your working directory:
2323

24-
`git clone https://github.com/ExaWorks/psi-j-python.git`
24+
`git clone https://github.com/ExaWorks/psij-python.git`
2525

26-
2. `cd psi-j-python`
26+
2. `cd psij-python`
2727
3. `pip install .`
2828

2929

@@ -85,4 +85,4 @@ for i in range(N):
8585
2. In this example the number of jobs is 1. Set *N* to the number of jobs you want to run and save file.
8686

8787
3. `python my-workflow.py`
88-
88+

README-testing.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -21,7 +21,7 @@ Setting up an automated testing job
2121

2222
This is the preferred way of running the tests since it allows the PSI/J
2323
team to keep a constant eye on the state of the library on various
24-
resources. To set up the Cron job (or an alternative method), you can either
24+
resources. To set up the Cron job (or an alternative method), you can either
2525
use the provided setup script:
2626

2727
```bash
@@ -67,7 +67,7 @@ Testing with pytest
6767
===================
6868

6969
This is the most direct way to run the tests and it must be done from the
70-
main psi-j directory. Use the following steps:
70+
main psij directory. Use the following steps:
7171

7272
1. Install dependencies:
7373
```bash

README.md

Lines changed: 8 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,14 @@
22

33
# Portable Submission Interface for Jobs
44

5-
PSI/J is an abstraction layer over cluster schedulers to write scheduler agnostic HPC applications. PSI/J automatically translates abstract job specifications into concrete scripts and commands to send to the scheduler. PSI/J is tested on a wide variety of clusters. For further information about [PSI/J](https://exaworks.org/job-api-spec/) or the [SDK](https://github.com/ExaWorks/SDK) visit the [ExaWorks](https://exaworks.org/) project page and read the [PSI/J documentation](https://exaworks.org/psi-j-python/#docs).
5+
PSI/J is an abstraction layer over cluster schedulers to write scheduler
6+
agnostic HPC applications. PSI/J automatically translates abstract job
7+
specifications into concrete scripts and commands to send to the
8+
scheduler. PSI/J is tested on a wide variety of clusters. For further
9+
information about [PSI/J](https://exaworks.org/job-api-spec/) or the
10+
[SDK](https://github.com/ExaWorks/SDK) visit the
11+
[ExaWorks](https://exaworks.org/) project page and read the [PSI/J
12+
documentation](https://exaworks.org/psij-python/#docs).
613

714

815
## Introduction

docs/development/contributing.rst

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -7,9 +7,9 @@ How to Contribute
77

88
PSI/J welcomes all who wish to contribute, whether that means adding new features,
99
fixing typos, reporting/fixing bugs, or writing documentation. Use the
10-
`GitHub repo <https://github.com/ExaWorks/psi-j-python>`_
10+
`GitHub repo <https://github.com/ExaWorks/psij-python>`_
1111
to create issues and pull requests. Please follow the
12-
`contributing guide <https://github.com/ExaWorks/psi-j-python/blob/main/CONTRIBUTING.md>`_.
12+
`contributing guide <https://github.com/ExaWorks/psij-python/blob/main/CONTRIBUTING.md>`_.
1313

1414
Please note that many high-level design questions may be better discussed in
1515
the `PSI/J design repo <https://github.com/ExaWorks/job-api-spec>`_, rather than the Python library implementation
@@ -32,11 +32,11 @@ The testing dashboard website
3232
To record your test results to PSI/J's public testing dashboard,
3333
and to schedule the test suite to run automatically on a timer,
3434
see the
35-
`testing README <https://github.com/ExaWorks/psi-j-python/blob/main/README-testing.md>`_.
35+
`testing README <https://github.com/ExaWorks/psij-python/blob/main/README-testing.md>`_.
3636

3737

3838
Building the Documentation
3939
--------------------------
4040

4141
See the instructions in the
42-
`README <https://github.com/ExaWorks/psi-j-python/blob/main/README-dev.md>`_.
42+
`README <https://github.com/ExaWorks/psij-python/blob/main/README-dev.md>`_.

docs/development/programming.rst

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -175,5 +175,5 @@ defined interface. This interface consists of:
175175
Writing a custom script based launcher can be as easy as subclassing
176176
:class:`~psij.launchers.script_based_launcher.ScriptBasedLauncher` and passing
177177
a launcher script path to the base class constructor. For example, see the
178-
`MPI launcher class <https://github.com/ExaWorks/psi-j-python/blob/main/src/psij/launchers/mpirun.py>` and the
179-
`MPI launcher script <https://github.com/ExaWorks/psi-j-python/blob/main/src/psij/launchers/scripts/mpi_launch.sh>`.
178+
`MPI launcher class <https://github.com/ExaWorks/psij-python/blob/main/src/psij/launchers/mpirun.py>` and the
179+
`MPI launcher script <https://github.com/ExaWorks/psij-python/blob/main/src/psij/launchers/scripts/mpi_launch.sh>`.

docs/getting_started.rst

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -19,15 +19,15 @@ Install from pip
1919

2020
.. code-block:: console
2121
22-
pip install psi-j
22+
pip install psij
2323
2424
Install from source
2525
^^^^^^^^^^^^^^^^^^^
2626

2727
.. code-block:: console
2828
29-
git clone https://github.com/ExaWorks/psi-j-python.git
30-
cd psi-j-python
29+
git clone https://github.com/ExaWorks/psij-python.git
30+
cd psij-python
3131
pip install .
3232
3333
@@ -290,7 +290,7 @@ Examples
290290
--------
291291

292292
Up-to-date and actively tested examples can be found
293-
`here <https://github.com/ExaWorks/psi-j-python/blob/main/tests/test_doc_examples.py>`_.
293+
`here <https://github.com/ExaWorks/psij-python/blob/main/tests/test_doc_examples.py>`_.
294294
Tests of resource-manager-specific and site-specific values
295295
(such as accounts, queues/partitions, etc.) can be found in files
296296
in the same directory but tend to buried under

psij-ci-run

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -52,7 +52,7 @@ else
5252
fi
5353

5454
# Ensure latest test runner is there
55-
git fetch https://github.com/ExaWorks/psi-j-python.git
55+
git fetch https://github.com/ExaWorks/psij-python.git
5656
git checkout FETCH_HEAD -- tests/ci_runner.py
5757

5858

scripts/WORKFLOW-EXAMPLES.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -163,7 +163,7 @@ for j in [make_job(pdf2textSingularitySpec, None), make_job(text2wordcloudSingul
163163

164164
## Executing an MPI job
165165

166-
In this example we demonstrate how to wrap and execute an mpi hello world job with PSI/J. The base mpi command is `mpiexec -n 36 -ppn 36 echo Hello world`. This example is introducing the concept of a [job launcher](https://exaworks.org/psi-j-python/docs/programming.html#launchers), in this case **mpi**, e.g. `job.spec.launcher = "mpirun"`. The complete example script can be found [here](./).
166+
In this example we demonstrate how to wrap and execute an mpi hello world job with PSI/J. The base mpi command is `mpiexec -n 36 -ppn 36 echo Hello world`. This example is introducing the concept of a [job launcher](https://exaworks.org/psij-python/docs/programming.html#launchers), in this case **mpi**, e.g. `job.spec.launcher = "mpirun"`. The complete example script can be found [here](./).
167167

168168
1. Load psij module and instanciate job executer, e.g. local or slurm
169169

setup.py

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -9,16 +9,16 @@
99
install_requires = f.readlines()
1010

1111
setup(
12-
name='psi-j-python',
12+
name='psij-python',
1313
version=VERSION,
1414

15-
description='''This is an implementation of the J/PSI (Portable Submission Interface for Jobs)
15+
description='''This is an implementation of the PSI/J (Portable Submission Interface for Jobs)
1616
specification.''',
1717

1818
author='The ExaWorks Team',
1919
author_email='[email protected]',
2020

21-
url='https://github.com/exaworks/psi-j-python',
21+
url='https://github.com/exaworks/psij-python',
2222

2323
classifiers=[
2424
'Programming Language :: Python :: 3',

testing.conf

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -174,4 +174,4 @@ max_age = 48
174174
# and to retrieve the list of PRs and their comments.
175175
#
176176

177-
repository = ExaWorks/psi-j-python
177+
repository = ExaWorks/psij-python

0 commit comments

Comments
 (0)