seq Standard library TODO

Hi Jordan,

let's start with the string library: https://docs.python.org/3/library/stdtypes.html#textseq

You can avoid string.format part for now.

Some functions (like str.split) are implemented in multiple places: for example, split on a single character is different than a split that operates on multi-character patterns.

Also, for each stdlib file, add the docs and implement a test suite as follows. For str.seq, add test_str.seq and there test each function, e.g.:

str.seq:

class str:
   def isspace(self: str) -> bool:
      """
      Doc
      """
      ...

test_str.seq:

def test_isspace():
    assert ' '.isspace() == True
    assert 'x'.isspace() == False
    # ... etc

Please check the function once done:

[x] str.capitalize()
[x] str.casefold()
[x] str.center(width[, fillchar])
[x] str.count(sub[, start[, end]])
[x] str.endswith(suffix[, start[, end]])
[x] str.expandtabs(tabsize=8)
[x] str.find(sub[, start[, end]])
[ ] ~~str.format(*args, **kwargs)~~
[x] str.index(sub[, start[, end]])
[x] str.isalnum()
[x] str.isalpha()
[x] str.isascii()
[x] str.isdecimal()
[x] str.isdigit()
[x] str.isidentifier()
[x] str.islower()
[x] str.isnumeric()
[x] str.isprintable()
[x] str.isspace()
[x] str.istitle()
[x] str.isupper()
[x] str.join(iterable)
[x] str.ljust(width[, fillchar])
[x] str.lower()
[x] str.lstrip([chars])
[x] str.partition(sep)
[x] str.replace(old, new[, count])
[x] str.rfind(sub[, start[, end]])
[x] str.rindex(sub[, start[, end]])
[x] str.rjust(width[, fillchar])
[x] str.rpartition(sep)
[x] str.rsplit(sep=None, maxsplit=-1)
[x] str.rstrip([chars])
[x] str.split(sep=None, maxsplit=-1)
[x] str.splitlines([keepends])
[x] str.startswith(prefix[, start[, end]])
[x] str.strip([chars])
[x] str.swapcase()
[x] str.title()
[x] str.translate(table)
[x] str.upper()
[x] str.zfill(width)

Mar 04 '19 16:03 inumanag

Next step: https://docs.python.org/3/library/math.html https://docs.python.org/3/library/random.html https://docs.python.org/3/library/statistics.html

Sep 25 '19 16:09 inumanag

Math

[x] math.ceil(x)
[x] math.copysign(x, y)
[x] math.fabs(x)
[ ] math.factorial(x)
[x] math.floor(x)
[x] math.fmod(x, y)
[x] math.frexp(x)
[ ] math.fsum(iterable)
[x] math.gcd(a, b)
[x] math.isclose(a, b, *, rel_tol=1e-09, abs_tol=0.0)
[x] math.isfinite(x)
[x] math.isinf(x)
[x] math.isnan(x)
[x] math.ldexp(x, i)
[x] math.modf(x)
[x] math.remainder(x, y)
[x] math.trunc(x)
[x] math.exp(x)
[x] math.expm1(x)
[x] math.log(x[, base])
[x] math.log1p(x)
[x] math.log2(x)
[x] math.log10(x)
[x] math.pow(x, y)
[x] math.sqrt(x)
[x] math.acos(x)
[x] math.asin(x)
[x] math.atan(x)
[x] math.atan2(y, x)
[x] math.cos(x)
[x] math.hypot(x, y)
[x] math.sin(x)
[x] math.tan(x)
[x] math.degrees(x)
[x] math.radians(x)
[x] math.acosh(x)
[x] math.asinh(x)
[x] math.atanh(x)
[x] math.cosh(x)
[x] math.sinh(x)
[x] math.tanh(x)
[x] math.erf(x)
[x] math.erfc(x)
[x] math.gamma(x)
[x] math.lgamma(x)
[x] math.pi
[x] math.e
[x] math.tau
[x] math.inf
[x] math.nan

Sep 25 '19 17:09 jordanwatson1

Random

[x] random.seed(a=None, version=2)
[ ] random.getstate()
[ ] random.setstate(state)
[x] random.getrandbits(k)
[x] random.randrange(stop)
[x] random.randrange(start, stop[, step])
[x] random.randint(a, b)
[x] random.choice(seq)
[x] random.choices(population, weights=None, *, cum_weights=None, k=1)
[x] random.shuffle(x[, random])
[ ] random.sample(population, k)
[x] random.random()
[x] random.uniform(a, b)
[x] random.triangular(low, high, mode)
[x] random.betavariate(alpha, beta)
[x] random.expovariate(lambd)
[x] random.gammavariate(alpha, beta)
[x] random.gauss(mu, sigma)
[x] random.lognormvariate(mu, sigma)
[x] random.normalvariate(mu, sigma)
[x] random.vonmisesvariate(mu, kappa)
[x] random.paretovariate(alpha)
[x] random.weibullvariate(alpha, beta)
[x] class random.Random([seed])
[ ] class random.SystemRandom([seed])

Oct 07 '19 19:10 jordanwatson1

itertools

[x] itertools.accumulate(iterable[, func, *, initial=None])
[x] itertools.chain(*iterables)
[x] classmethod chain.from_iterable(iterable)
[x] itertools.combinations(iterable, r)
[x] itertools.combinations_with_replacement(iterable, r)
[x] itertools.compress(data, selectors)
[x] itertools.count(start=0, step=1)
[x] itertools.cycle(iterable)
[x] itertools.dropwhile(predicate, iterable)
[x] itertools.filterfalse(predicate, iterable)
[ ] itertools.groupby(iterable, key=None)
[x] itertools.islice(iterable, stop)
[x] itertools.islice(iterable, start, stop[, step])
[x] itertools.permutations(iterable, r=None)
[ ] itertools.product(*iterables, repeat=1)
[x] itertools.repeat(object[, times])
[x] itertools.starmap(function, iterable)
[x] itertools.takewhile(predicate, iterable)
[ ] itertools.tee(iterable, n=2)
[ ] itertools.zip_longest(*iterables, fillvalue=None)

Nov 01 '19 00:11 jordanwatson1

Next steps:

collections --- Counter, ChainMap, deque, defaultdict and OrderedDict
bisect -- one part is already there
heapq
statistics
os -- can you prepare the list of all os symbols that I can pick from later on?
getopt

Nov 13 '19 06:11 inumanag

bisect

[x] bisect.bisect_left(a, x, lo=0, hi=len(a))
[x] bisect.bisect_right(a, x, lo=0, hi=len(a))
[x] bisect.bisect(a, x, lo=0, hi=len(a))
[x] bisect.insort_left(a, x, lo=0, hi=len(a))
[x] bisect.insort_right(a, x, lo=0, hi=len(a))
[x] bisect.insort(a, x, lo=0, hi=len(a))

Nov 15 '19 19:11 jordanwatson1

collections

class collections.Counter([iterable-or-mapping])

[ ] Counter.elements()
[ ] Counter.most_common([n])
[ ] Counter.subtract([iterable-or-mapping])
[ ] Counter.fromkeys(iterable)
[ ] Counter.update([iterable-or-mapping])

class collections.deque([iterable[, maxlen]])

[x] deque.append(x)
[x] deque.appendleft(x)
[x] deque.clear()
[ ] deque.copy()
[ ] deque.count(x)
[ ] deque.extend(iterable)
[ ] deque.extendleft(iterable)
[ ] deque.index(x[, start[, stop]])
[ ] deque.insert(i, x)
[x] deque.pop()
[x] deque.popleft()
[ ] deque.remove(value)
[ ] deque.reverse()
[ ] deque.rotate(n=1)
[x] deque.maxlen

Nov 18 '19 19:11 jordanwatson1

heapq

[x] heapq.heappush(heap, item)
[x] heapq.heappop(heap)
[x] heapq.heappushpop(heap, item)
[x] heapq.heapify(x)
[x] heapq.heapreplace(heap, item)
[x] heapq.merge(*iterables, key=None, reverse=False)
[x] heapq.nlargest(n, iterable, key=None)
[x] heapq.nsmallest(n, iterable, key=None)

Nov 18 '19 20:11 jordanwatson1

statistics

[x] statistics.mean(data)
[x] statistics.fmean(data)
[x] statistics.geometric_mean(data)
[x] statistics.harmonic_mean(data)
[x] statistics.median(data)
[x] statistics.median_low(data)
[x] statistics.median_high(data)
[x] statistics.median_grouped(data, interval=1)
[x] statistics.mode(data)
[x] statistics.multimode(data)
[x] statistics.pstdev(data, mu=None)
[x] statistics.pvariance(data, mu=None)
[x] statistics.stdev(data, xbar=None)
[x] statistics.variance(data, xbar=None)
[x] statistics.quantiles(data, *, n=4, method='exclusive')
[x] class statistics.NormalDist(mu=0.0, sigma=1.0)
- [x] mean
- [x] median
- [x] mode
- [x] stdev
- [x] variance
- [x] classmethod from_samples(data)
- [x] samples(n, *, seed=None)
- [x] pdf(x)
- [x] cdf(x)
- [x] inv_cdf(p)
- [x] overlap(other)
- [x] quantiles(n=4)

Nov 18 '19 20:11 jordanwatson1

os

[ ] exception os.error
[ ] os.name

Process Parameters

[ ] os.ctermid()
[ ] os.environ
[ ] os.environb
[ ] os.chdir(path)
[ ] os.fchdir(fd)
[ ] os.getcwd()
[ ] os.fsencode(filename)
[ ] os.fsdecode(filename)
[ ] os.fspath(path)
[ ] class os.PathLike
- [ ] abstractmethod fspath()
[ ] os.getenv(key, default=None)
[ ] os.getenvb(key, default=None)
[ ] os.get_exec_path(env=None)
[ ] os.getegid()
[ ] os.geteuid()
[ ] os.getgid()
[ ] os.getgrouplist(user, group)
[ ] os.getgroups()
[ ] os.getlogin()
[ ] os.getpgid(pid)
[ ] os.getpgrp()
[ ] os.getpid()
[ ] os.getppid()
[ ] os.getpriority(which, who)
[ ] os.PRIO_PROCESS
[ ] os.PRIO_PGRP
[ ] os.PRIO_USER
[ ] os.getresuid()
[ ] os.getresgid()
[ ] os.getuid()
[ ] os.initgroups(username, gid)
[ ] os.putenv(key, value)
[ ] os.setegid(egid)
[ ] os.seteuid(euid)
[ ] os.setgid(gid)
[ ] os.setgroups(groups)
[ ] os.setpgrp()
[ ] os.setpgid(pid, pgrp)
[ ] os.setpriority(which, who, priority)
[ ] os.setregid(rgid, egid)
[ ] os.setresgid(rgid, egid, sgid)
[ ] os.setresuid(ruid, euid, suid)
[ ] os.setreuid(ruid, euid)
[ ] os.getsid(pid)
[ ] os.setsid()
[ ] os.setuid(uid)
[ ] os.strerror(code)
[ ] os.supports_bytes_environ
[ ] os.umask(mask)
[ ] os.uname()
[ ] os.unsetenv(key)

File Object Creation

[ ] os.fdopen(fd, *args, **kwargs)

File Descriptor Operations

[ ] os.close(fd)
[ ] os.closerange(fd_low, fd_high)
[ ] os.copy_file_range(src, dst, count, offset_src=None, offset_dst=None)
[ ] os.device_encoding(fd)
[ ] os.dup(fd)
[ ] os.dup2(fd, fd2, inheritable=True)
[ ] os.fchmod(fd, mode)
[ ] os.fchown(fd, uid, gid)
[ ] os.fdatasync(fd)
[ ] os.fpathconf(fd, name)
[ ] os.fstat(fd)
[ ] os.fstatvfs(fd)
[ ] os.fsync(fd)
[ ] os.ftruncate(fd, length)
[ ] os.get_blocking(fd)
[ ] os.isatty(fd)
[ ] os.lockf(fd, cmd, len)
[ ] os.F_LOCK
[ ] os.F_TLOCK
[ ] os.F_ULOCK
[ ] os.F_TEST
[ ] os.lseek(fd, pos, how)
[ ] os.SEEK_SET
[ ] os.SEEK_CUR
[ ] os.SEEK_END
[ ] os.open(path, flags, mode=0o777, *, dir_fd=None)
[ ] os.O_RDONLY
[ ] os.O_WRONLY
[ ] os.O_RDWR
[ ] os.O_APPEND
[ ] os.O_CREAT
[ ] os.O_EXCL
[ ] os.O_TRUNC
[ ] os.O_DSYNC
[ ] os.O_RSYNC
[ ] os.O_SYNC
[ ] os.O_NDELAY
[ ] os.O_NONBLOCK
[ ] os.O_NOCTTY
[ ] os.O_CLOEXEC
[ ] os.O_BINARY
[ ] os.O_NOINHERIT
[ ] os.O_SHORT_LIVED
[ ] os.O_TEMPORARY
[ ] os.O_RANDOM
[ ] os.O_SEQUENTIAL
[ ] os.O_TEXT
[ ] os.O_ASYNC
[ ] os.O_DIRECT
[ ] os.O_DIRECTORY
[ ] os.O_NOFOLLOW
[ ] os.O_NOATIME
[ ] os.O_PATH
[ ] os.O_TMPFILE
[ ] os.O_SHLOCK
[ ] os.O_EXLOCK
[ ] os.openpty()
[ ] os.pipe()
[ ] os.pipe2(flags)
[ ] os.posix_fallocate(fd, offset, len)
[ ] os.posix_fadvise(fd, offset, len, advice)
[ ] os.POSIX_FADV_NORMAL
[ ] os.POSIX_FADV_SEQUENTIAL
[ ] os.POSIX_FADV_RANDOM
[ ] os.POSIX_FADV_NOREUSE
[ ] os.POSIX_FADV_WILLNEED
[ ] os.POSIX_FADV_DONTNEED
[ ] os.pread(fd, n, offset)
[ ] os.preadv(fd, buffers, offset, flags=0)
[ ] os.RWF_NOWAIT
[ ] os.RWF_HIPRI
[ ] os.pwrite(fd, str, offset)
[ ] os.pwritev(fd, buffers, offset, flags=0)
[ ] os.RWF_DSYNC
[ ] os.RWF_SYNC
[ ] os.read(fd, n)
[ ] os.sendfile(out, in, offset, count)
[ ] os.sendfile(out, in, offset, count, [headers, ][trailers, ]flags=0)
[ ] os.set_blocking(fd, blocking)
[ ] os.SF_NODISKIO
[ ] os.SF_MNOWAIT
[ ] os.SF_SYNC
[ ] os.readv(fd, buffers)
[ ] os.tcgetpgrp(fd)
[ ] os.tcsetpgrp(fd, pg)
[ ] os.ttyname(fd)
[ ] os.write(fd, str)
[ ] os.writev(fd, buffers)

Querying the size of a terminal

[ ] os.get_terminal_size(fd=STDOUT_FILENO)
[ ] class os.terminal_size
- [ ] columns
- [ ] lines

Inheritance of File Descriptors

[ ] os.get_inheritable(fd)
[ ] os.set_inheritable(fd, inheritable)
[ ] os.get_handle_inheritable(handle)
[ ] os.set_handle_inheritable(handle, inheritable)

Files and Directories

[ ] os.access(path, mode, *, dir_fd=None, effective_ids=False, follow_symlinks=True)
[ ] os.F_OK
[ ] os.R_OK
[ ] os.W_OK
[ ] os.X_OK
[ ] os.chdir(path)
[ ] os.chflags(path, flags, *, follow_symlinks=True)
[ ] os.chmod(path, mode, *, dir_fd=None, follow_symlinks=True)
[ ] os.chown(path, uid, gid, *, dir_fd=None, follow_symlinks=True)
[ ] os.chroot(path)
[ ] os.fchdir(fd)
[ ] os.getcwd()
[ ] os.getcwdb()
[ ] os.lchflags(path, flags)
[ ] os.lchmod(path, mode)
[ ] os.lchown(path, uid, gid)
[ ] os.link(src, dst, *, src_dir_fd=None, dst_dir_fd=None, follow_symlinks=True)
[ ] os.listdir(path='.')
[ ] os.lstat(path, *, dir_fd=None)
[ ] os.mkdir(path, mode=0o777, *, dir_fd=None)
[ ] os.makedirs(name, mode=0o777, exist_ok=False)
[ ] os.mkfifo(path, mode=0o666, *, dir_fd=None)
[ ] os.mknod(path, mode=0o600, device=0, *, dir_fd=None)
[ ] os.major(device)
[ ] os.minor(device)
[ ] os.makedev(major, minor)
[ ] os.pathconf(path, name)
[ ] os.pathconf_names
[ ] os.readlink(path, *, dir_fd=None)
[ ] os.remove(path, *, dir_fd=None)
[ ] os.removedirs(name)
[ ] os.rename(src, dst, *, src_dir_fd=None, dst_dir_fd=None)
[ ] os.renames(old, new)
[ ] os.replace(src, dst, *, src_dir_fd=None, dst_dir_fd=None)
[ ] os.rmdir(path, *, dir_fd=None)
[ ] os.scandir(path='.')
[ ] class os.DirEntry
- [ ] name
- [ ] path
- [ ] inode()
- [ ] is_dir(*, follow_symlinks=True)
- [ ] is_file(*, follow_symlinks=True)
- [ ] is_symlink()
- [ ] stat(*, follow_symlinks=True)
[ ] os.stat(path, *, dir_fd=None, follow_symlinks=True)
[ ] class os.stat_result
- [ ] st_mode
- [ ] st_ino
- [ ] st_dev
- [ ] st_nlink
- [ ] st_uid
- [ ] st_gid
- [ ] st_size
- [ ] st_atime
- [ ] st_mtime
- [ ] st_ctime
- [ ] st_atime_ns
- [ ] st_mtime_ns
- [ ] st_ctime_ns
- [ ] st_blocks
- [ ] st_blksize
- [ ] st_rdev
- [ ] st_flags
- [ ] st_gen
- [ ] st_birthtime
- [ ] st_fstype
- [ ] st_rsize
- [ ] st_creator
- [ ] st_type
- [ ] st_file_attributes
- [ ] st_reparse_tag
[ ] os.statvfs(path)
[ ] os.supports_dir_fd
[ ] os.supports_effective_ids
[ ] os.supports_fd
[ ] os.supports_follow_symlinks
[ ] os.symlink(src, dst, target_is_directory=False, *, dir_fd=None)
[ ] os.sync()
[ ] os.truncate(path, length)
[ ] os.unlink(path, *, dir_fd=None)
[ ] os.utime(path, times=None, *, [ns, ]dir_fd=None, follow_symlinks=True)
[ ] os.walk(top, topdown=True, onerror=None, followlinks=False)
[ ] os.fwalk(top='.', topdown=True, onerror=None, *, follow_symlinks=False, dir_fd=None)
[ ] os.memfd_create(name[, flags=os.MFD_CLOEXEC])
[ ] os.MFD_CLOEXEC
[ ] os.MFD_ALLOW_SEALING
[ ] os.MFD_HUGETLB
[ ] os.MFD_HUGE_SHIFT
[ ] os.MFD_HUGE_MASK
[ ] os.MFD_HUGE_64KB
[ ] os.MFD_HUGE_512KB
[ ] os.MFD_HUGE_1MB
[ ] os.MFD_HUGE_2MB
[ ] os.MFD_HUGE_8MB
[ ] os.MFD_HUGE_16MB
[ ] os.MFD_HUGE_32MB
[ ] os.MFD_HUGE_256MB
[ ] os.MFD_HUGE_512MB
[ ] os.MFD_HUGE_1GB
[ ] os.MFD_HUGE_2GB
[ ] os.MFD_HUGE_16GB

Linux extended attributes

[ ] os.getxattr(path, attribute, *, follow_symlinks=True)
[ ] os.listxattr(path=None, *, follow_symlinks=True)
[ ] os.removexattr(path, attribute, *, follow_symlinks=True)
[ ] os.setxattr(path, attribute, value, flags=0, *, follow_symlinks=True)
[ ] os.XATTR_SIZE_MAX
[ ] os.XATTR_CREATE
[ ] os.XATTR_REPLACE

Process Management

[ ] os.abort()
[ ] os.add_dll_directory(path)
[ ] os.execl(path, arg0, arg1, ...)
[ ] os.execle(path, arg0, arg1, ..., env)
[ ] os.execlp(file, arg0, arg1, ...)
[ ] os.execlpe(file, arg0, arg1, ..., env)
[ ] os.execv(path, args)
[ ] os.execve(path, args, env)
[ ] os.execvp(file, args)
[ ] os.execvpe(file, args, env)
[ ] os.EX_OK
[ ] os.EX_USAGE
[ ] os.EX_DATAERR
[ ] os.EX_NOINPUT
[ ] os.EX_NOUSER
[ ] os.EX_NOHOST
[ ] os.EX_UNAVAILABLE
[ ] os.EX_SOFTWARE
[ ] os.EX_OSERR
[ ] os.EX_OSFILE
[ ] os.EX_CANTCREAT
[ ] os.EX_IOERR
[ ] os.EX_TEMPFAIL
[ ] os.EX_PROTOCOL
[ ] os.EX_NOPERM
[ ] os.EX_CONFIG
[ ] os.EX_NOTFOUND
[ ] os.fork()
[ ] os.forkpty()
[ ] os.kill(pid, sig)
[ ] os.killpg(pgid, sig)
[ ] os.nice(increment)
[ ] os.plock(op)
[ ] os.popen(cmd, mode='r', buffering=-1)
[ ] os.posix_spawn(path, argv, env, *, file_actions=None, setpgroup=None, resetids=False, setsid=False, setsigmask=(), setsigdef=(), scheduler=None)
[ ] os.posix_spawnp(path, argv, env, *, file_actions=None, setpgroup=None, resetids=False, setsid=False, setsigmask=(), setsigdef=(), scheduler=None)
[ ] os.register_at_fork(*, before=None, after_in_parent=None, after_in_child=None)
[ ] os.spawnl(mode, path, ...)
[ ] os.spawnle(mode, path, ..., env)
[ ] os.spawnlp(mode, file, ...)
[ ] os.spawnlpe(mode, file, ..., env)
[ ] os.spawnv(mode, path, args)
[ ] os.spawnve(mode, path, args, env)
[ ] os.spawnvp(mode, file, args)
[ ] os.spawnvpe(mode, file, args, env)
[ ] os.P_NOWAIT
[ ] os.P_NOWAITO
[ ] os.P_WAIT
[ ] os.P_DETACH
[ ] os.P_OVERLAY
[ ] os.startfile(path[, operation])
[ ] os.system(command)
[ ] os.times()
[ ] os.wait()
[ ] os.waitid(idtype, id, options)
[ ] os.P_PID
[ ] os.P_PGID
[ ] os.P_ALL
[ ] os.WEXITED
[ ] os.WSTOPPED
[ ] os.WNOWAIT
[ ] os.CLD_EXITED
[ ] os.CLD_DUMPED
[ ] os.CLD_TRAPPED
[ ] os.CLD_CONTINUED
[ ] os.waitpid(pid, options)
[ ] os.wait3(options)
[ ] os.wait4(pid, options)
[ ] os.WNOHANG
[ ] os.WCONTINUED
[ ] os.WUNTRACED
[ ] os.WCOREDUMP(status)
[ ] os.WIFCONTINUED(status)
[ ] os.WIFSTOPPED(status)
[ ] os.WIFSIGNALED(status)
[ ] os.WIFEXITED(status)
[ ] os.WEXITSTATUS(status)
[ ] os.WSTOPSIG(status)
[ ] os.WTERMSIG(status)